@ue-shed/observatory 0.1.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +21 -0
- package/README.md +53 -0
- package/dist/actor-feed.d.ts +90 -0
- package/dist/actor-feed.d.ts.map +1 -0
- package/dist/actor-feed.js +566 -0
- package/dist/actor-feed.js.map +1 -0
- package/dist/actor-identity.d.ts +6 -0
- package/dist/actor-identity.d.ts.map +1 -0
- package/dist/actor-identity.js +22 -0
- package/dist/actor-identity.js.map +1 -0
- package/dist/actor-models.d.ts +78 -0
- package/dist/actor-models.d.ts.map +1 -0
- package/dist/actor-models.js +28 -0
- package/dist/actor-models.js.map +1 -0
- package/dist/actor-stream-protocol.d.ts +86 -0
- package/dist/actor-stream-protocol.d.ts.map +1 -0
- package/dist/actor-stream-protocol.js +305 -0
- package/dist/actor-stream-protocol.js.map +1 -0
- package/dist/index.d.ts +173 -0
- package/dist/index.d.ts.map +1 -0
- package/dist/index.js +161 -0
- package/dist/index.js.map +1 -0
- package/dist/presentation.d.ts +9 -0
- package/dist/presentation.d.ts.map +1 -0
- package/dist/presentation.js +8 -0
- package/dist/presentation.js.map +1 -0
- package/dist/world-observation.d.ts +232 -0
- package/dist/world-observation.d.ts.map +1 -0
- package/dist/world-observation.js +335 -0
- package/dist/world-observation.js.map +1 -0
- package/package.json +49 -0
|
@@ -0,0 +1,566 @@
|
|
|
1
|
+
import { recordObservatoryPacket, recordObservatoryReceiverReplacements } from "@ue-shed/observability";
|
|
2
|
+
import { RemoteControlClientError } from "@ue-shed/unreal-connection";
|
|
3
|
+
import { Context, Duration, Effect, Layer, PubSub, Result, Schedule, Schema, Stream } from "effect";
|
|
4
|
+
import { createServer } from "node:net";
|
|
5
|
+
import { ActorId, WorldActorSnapshot, WorldVector } from "./actor-models.js";
|
|
6
|
+
import { ACTOR_STREAM_HEADER_BYTES, ACTOR_STREAM_RECORD_BYTES, ActorStreamDecoder, actorStreamPacketToTransformBatch } from "./actor-stream-protocol.js";
|
|
7
|
+
import { applyWorldObservationEvent, catalogFromWireEntries, CatalogRevision, connectingState, ObservationSessionId, StreamActorIndex } from "./world-observation.js";
|
|
8
|
+
const objectPath = "/Script/UEShedObservatoryEditor.Default__UEShedObservatoryLibrary";
|
|
9
|
+
export class ActorFeedError extends Schema.TaggedErrorClass()("ActorFeedError", {
|
|
10
|
+
message: Schema.String,
|
|
11
|
+
operation: Schema.Literals(["listen", "decode_limit"]),
|
|
12
|
+
pipeName: Schema.String,
|
|
13
|
+
retrySafe: Schema.Boolean
|
|
14
|
+
}) {
|
|
15
|
+
}
|
|
16
|
+
export class ActorFeed extends Context.Service()("@ue-shed/observatory/ActorFeed") {
|
|
17
|
+
}
|
|
18
|
+
function listen(server, pipeName) {
|
|
19
|
+
return Effect.tryPromise({
|
|
20
|
+
try: (signal) => new Promise((resolve, reject) => {
|
|
21
|
+
const cleanup = () => {
|
|
22
|
+
server.off("error", onError);
|
|
23
|
+
server.off("listening", onListening);
|
|
24
|
+
signal.removeEventListener("abort", onAbort);
|
|
25
|
+
};
|
|
26
|
+
const onAbort = () => {
|
|
27
|
+
cleanup();
|
|
28
|
+
try {
|
|
29
|
+
server.close();
|
|
30
|
+
}
|
|
31
|
+
catch {
|
|
32
|
+
// The server may not have started listening yet.
|
|
33
|
+
}
|
|
34
|
+
reject(signal.reason);
|
|
35
|
+
};
|
|
36
|
+
const onError = (cause) => {
|
|
37
|
+
cleanup();
|
|
38
|
+
reject(cause);
|
|
39
|
+
};
|
|
40
|
+
const onListening = () => {
|
|
41
|
+
cleanup();
|
|
42
|
+
resolve();
|
|
43
|
+
};
|
|
44
|
+
server.once("error", onError);
|
|
45
|
+
server.once("listening", onListening);
|
|
46
|
+
signal.addEventListener("abort", onAbort, { once: true });
|
|
47
|
+
server.listen(pipeName);
|
|
48
|
+
}),
|
|
49
|
+
catch: (cause) => new ActorFeedError({
|
|
50
|
+
message: String(cause),
|
|
51
|
+
operation: "listen",
|
|
52
|
+
pipeName,
|
|
53
|
+
retrySafe: true
|
|
54
|
+
})
|
|
55
|
+
});
|
|
56
|
+
}
|
|
57
|
+
function closeActorFeed(resource) {
|
|
58
|
+
return Effect.gen(function* () {
|
|
59
|
+
for (const socket of resource.sockets)
|
|
60
|
+
socket.destroy();
|
|
61
|
+
yield* Effect.callback((resume) => {
|
|
62
|
+
if (!resource.server.listening) {
|
|
63
|
+
resume(Effect.void);
|
|
64
|
+
return;
|
|
65
|
+
}
|
|
66
|
+
resource.server.close(() => resume(Effect.void));
|
|
67
|
+
});
|
|
68
|
+
yield* PubSub.shutdown(resource.pubsub);
|
|
69
|
+
});
|
|
70
|
+
}
|
|
71
|
+
function acquireActorFeedResource(options) {
|
|
72
|
+
const pipeName = options.pipeName;
|
|
73
|
+
const capacity = options.capacity ?? 8;
|
|
74
|
+
const maxMalformedPackets = options.maxMalformedPackets ?? 128;
|
|
75
|
+
if (!Number.isInteger(capacity) || capacity <= 0) {
|
|
76
|
+
return Effect.fail(new ActorFeedError({
|
|
77
|
+
message: `Actor feed capacity must be a positive integer, received ${capacity}.`,
|
|
78
|
+
operation: "listen",
|
|
79
|
+
pipeName,
|
|
80
|
+
retrySafe: false
|
|
81
|
+
}));
|
|
82
|
+
}
|
|
83
|
+
if (!Number.isInteger(maxMalformedPackets) || maxMalformedPackets <= 0) {
|
|
84
|
+
return Effect.fail(new ActorFeedError({
|
|
85
|
+
message: `Actor feed maxMalformedPackets must be a positive integer, received ${maxMalformedPackets}.`,
|
|
86
|
+
operation: "decode_limit",
|
|
87
|
+
pipeName,
|
|
88
|
+
retrySafe: false
|
|
89
|
+
}));
|
|
90
|
+
}
|
|
91
|
+
return Effect.gen(function* () {
|
|
92
|
+
const scope = yield* Effect.scope;
|
|
93
|
+
const pubsub = yield* PubSub.sliding(capacity);
|
|
94
|
+
let latest;
|
|
95
|
+
const sockets = new Set();
|
|
96
|
+
const startedMonotonicMs = performance.now();
|
|
97
|
+
let bytesReceived = 0;
|
|
98
|
+
let decodeLimitDrops = 0;
|
|
99
|
+
let deliveryReplacements = 0;
|
|
100
|
+
let malformedPackets = 0;
|
|
101
|
+
let packetsReceived = 0;
|
|
102
|
+
let transportErrors = 0;
|
|
103
|
+
const server = createServer((socket) => {
|
|
104
|
+
sockets.add(socket);
|
|
105
|
+
const decoder = new ActorStreamDecoder();
|
|
106
|
+
let consecutiveMalformed = 0;
|
|
107
|
+
socket.on("error", () => {
|
|
108
|
+
transportErrors += 1;
|
|
109
|
+
});
|
|
110
|
+
socket.on("data", (chunk) => {
|
|
111
|
+
bytesReceived += chunk.byteLength;
|
|
112
|
+
const decoded = decoder.push(chunk);
|
|
113
|
+
malformedPackets += decoded.malformed;
|
|
114
|
+
consecutiveMalformed =
|
|
115
|
+
decoded.packets.length > 0
|
|
116
|
+
? decoded.malformed
|
|
117
|
+
: consecutiveMalformed + decoded.malformed;
|
|
118
|
+
for (const packet of decoded.packets) {
|
|
119
|
+
latest = packet;
|
|
120
|
+
packetsReceived += 1;
|
|
121
|
+
Effect.runFork(Effect.forkIn(Effect.gen(function* () {
|
|
122
|
+
if ((yield* PubSub.size(pubsub)) >= capacity) {
|
|
123
|
+
deliveryReplacements += 1;
|
|
124
|
+
yield* recordObservatoryReceiverReplacements(1);
|
|
125
|
+
}
|
|
126
|
+
yield* PubSub.publish(pubsub, packet);
|
|
127
|
+
}), scope));
|
|
128
|
+
}
|
|
129
|
+
if (consecutiveMalformed >= maxMalformedPackets) {
|
|
130
|
+
decodeLimitDrops += 1;
|
|
131
|
+
socket.destroy();
|
|
132
|
+
}
|
|
133
|
+
});
|
|
134
|
+
socket.once("close", () => sockets.delete(socket));
|
|
135
|
+
});
|
|
136
|
+
yield* listen(server, pipeName);
|
|
137
|
+
server.on("error", () => {
|
|
138
|
+
transportErrors += 1;
|
|
139
|
+
});
|
|
140
|
+
return {
|
|
141
|
+
feed: {
|
|
142
|
+
latestPacket: Effect.sync(() => latest),
|
|
143
|
+
metrics: Effect.sync(() => ({
|
|
144
|
+
bytesReceived,
|
|
145
|
+
decodeLimitDrops,
|
|
146
|
+
deliveryReplacements,
|
|
147
|
+
malformedPackets,
|
|
148
|
+
packetsReceived,
|
|
149
|
+
startedMonotonicMs,
|
|
150
|
+
transportErrors
|
|
151
|
+
})),
|
|
152
|
+
packets: Stream.fromPubSub(pubsub)
|
|
153
|
+
},
|
|
154
|
+
pubsub,
|
|
155
|
+
server,
|
|
156
|
+
sockets
|
|
157
|
+
};
|
|
158
|
+
});
|
|
159
|
+
}
|
|
160
|
+
/** Scoped acquisition usable directly (bypassing `Context`) when the pipe name is dynamic. */
|
|
161
|
+
export function acquireActorFeedScoped(options) {
|
|
162
|
+
return Effect.acquireRelease(acquireActorFeedResource(options), closeActorFeed).pipe(Effect.map((resource) => resource.feed));
|
|
163
|
+
}
|
|
164
|
+
export function actorFeedLayer(options) {
|
|
165
|
+
return Layer.effect(ActorFeed, acquireActorFeedScoped(options));
|
|
166
|
+
}
|
|
167
|
+
export function makeActorFeedTestLayer(feed = {}) {
|
|
168
|
+
return Layer.succeed(ActorFeed, {
|
|
169
|
+
latestPacket: feed.latestPacket ?? Effect.succeed(undefined),
|
|
170
|
+
metrics: feed.metrics ??
|
|
171
|
+
Effect.succeed({
|
|
172
|
+
bytesReceived: 0,
|
|
173
|
+
decodeLimitDrops: 0,
|
|
174
|
+
deliveryReplacements: 0,
|
|
175
|
+
malformedPackets: 0,
|
|
176
|
+
packetsReceived: 0,
|
|
177
|
+
startedMonotonicMs: 0,
|
|
178
|
+
transportErrors: 0
|
|
179
|
+
}),
|
|
180
|
+
packets: feed.packets ?? Stream.empty
|
|
181
|
+
});
|
|
182
|
+
}
|
|
183
|
+
// ---------------------------------------------------------------------------
|
|
184
|
+
// Control-plane negotiation: StartActorObservation / StopActorObservation /
|
|
185
|
+
// GetActorSnapshot, plus the typed errors for control negotiation, session
|
|
186
|
+
// mismatch, and bounded recovery exhaustion.
|
|
187
|
+
// ---------------------------------------------------------------------------
|
|
188
|
+
export class ActorObservationControlError extends Schema.TaggedErrorClass()("ActorObservationControlError", {
|
|
189
|
+
endpoint: Schema.String,
|
|
190
|
+
message: Schema.String,
|
|
191
|
+
operation: Schema.Literals(["start", "stop", "status"]),
|
|
192
|
+
retrySafe: Schema.Boolean,
|
|
193
|
+
status: Schema.optional(Schema.Number)
|
|
194
|
+
}) {
|
|
195
|
+
}
|
|
196
|
+
export class ActorObservationSessionError extends Schema.TaggedErrorClass()("ActorObservationSessionError", {
|
|
197
|
+
endpoint: Schema.String,
|
|
198
|
+
expectedSessionId: Schema.String,
|
|
199
|
+
message: Schema.String,
|
|
200
|
+
receivedSessionId: Schema.String
|
|
201
|
+
}) {
|
|
202
|
+
}
|
|
203
|
+
export class ActorObservationRecoveryExhaustedError extends Schema.TaggedErrorClass()("ActorObservationRecoveryExhaustedError", {
|
|
204
|
+
attempts: Schema.Int,
|
|
205
|
+
endpoint: Schema.String,
|
|
206
|
+
message: Schema.String
|
|
207
|
+
}) {
|
|
208
|
+
}
|
|
209
|
+
const WireCatalogActor = Schema.Struct({
|
|
210
|
+
bounds: Schema.Struct({ center: WorldVector, extent: WorldVector }),
|
|
211
|
+
className: Schema.NonEmptyString,
|
|
212
|
+
displayName: Schema.NonEmptyString,
|
|
213
|
+
id: ActorId,
|
|
214
|
+
location: WorldVector,
|
|
215
|
+
path: Schema.NonEmptyString,
|
|
216
|
+
rotation: WorldVector,
|
|
217
|
+
streamIndex: StreamActorIndex
|
|
218
|
+
});
|
|
219
|
+
const WireCatalog = Schema.Struct({
|
|
220
|
+
actors: Schema.Array(WireCatalogActor),
|
|
221
|
+
capturedAt: Schema.String,
|
|
222
|
+
mapPath: Schema.NonEmptyString,
|
|
223
|
+
worldKind: Schema.Literals(["editor", "pie"]),
|
|
224
|
+
worldSeconds: Schema.Finite
|
|
225
|
+
});
|
|
226
|
+
const StartActorObservationReady = Schema.Struct({
|
|
227
|
+
status: Schema.Literal("ready"),
|
|
228
|
+
capability: Schema.Literal("stream"),
|
|
229
|
+
cadenceHz: Schema.Int,
|
|
230
|
+
catalog: WireCatalog,
|
|
231
|
+
catalogRevision: Schema.NonEmptyString,
|
|
232
|
+
limits: Schema.Struct({ maxActors: Schema.Int, maxCadenceHz: Schema.Int }),
|
|
233
|
+
pipeName: Schema.NonEmptyString,
|
|
234
|
+
sessionId: Schema.NonEmptyString
|
|
235
|
+
});
|
|
236
|
+
const StartActorObservationNotSupported = Schema.Struct({
|
|
237
|
+
status: Schema.Literal("not_supported"),
|
|
238
|
+
message: Schema.String,
|
|
239
|
+
recovery: Schema.String
|
|
240
|
+
});
|
|
241
|
+
const StartActorObservationFailed = Schema.Struct({
|
|
242
|
+
status: Schema.Literal("failed"),
|
|
243
|
+
message: Schema.String,
|
|
244
|
+
recovery: Schema.String
|
|
245
|
+
});
|
|
246
|
+
const StartActorObservationResponse = Schema.Union([
|
|
247
|
+
StartActorObservationReady,
|
|
248
|
+
StartActorObservationNotSupported,
|
|
249
|
+
StartActorObservationFailed
|
|
250
|
+
]);
|
|
251
|
+
const SnapshotResponse = Schema.Union([
|
|
252
|
+
Schema.Struct({ status: Schema.Literal("ready"), snapshot: WorldActorSnapshot }),
|
|
253
|
+
Schema.Struct({
|
|
254
|
+
status: Schema.Literal("failed"),
|
|
255
|
+
message: Schema.String,
|
|
256
|
+
recovery: Schema.String
|
|
257
|
+
})
|
|
258
|
+
]);
|
|
259
|
+
function controlError(endpoint, operation, cause) {
|
|
260
|
+
if (cause instanceof RemoteControlClientError) {
|
|
261
|
+
return new ActorObservationControlError({
|
|
262
|
+
endpoint: cause.endpoint,
|
|
263
|
+
message: cause.message,
|
|
264
|
+
operation,
|
|
265
|
+
retrySafe: cause.retrySafe,
|
|
266
|
+
...(cause.status === undefined ? {} : { status: cause.status })
|
|
267
|
+
});
|
|
268
|
+
}
|
|
269
|
+
return new ActorObservationControlError({
|
|
270
|
+
endpoint,
|
|
271
|
+
message: `Invalid observatory ${operation} response: ${String(cause)}`,
|
|
272
|
+
operation,
|
|
273
|
+
retrySafe: false
|
|
274
|
+
});
|
|
275
|
+
}
|
|
276
|
+
const callStartActorObservation = Effect.fn("ActorObservation.start")(function* (remote, endpoint, cadenceHz) {
|
|
277
|
+
const value = yield* remote
|
|
278
|
+
.request({
|
|
279
|
+
endpoint,
|
|
280
|
+
functionName: "StartActorObservation",
|
|
281
|
+
objectPath,
|
|
282
|
+
operation: "observatory.start_actor_observation",
|
|
283
|
+
parameters: { RequestJson: JSON.stringify({ cadenceHz }) }
|
|
284
|
+
})
|
|
285
|
+
.pipe(Effect.mapError((cause) => controlError(endpoint, "start", cause)));
|
|
286
|
+
return yield* Schema.decodeUnknownEffect(StartActorObservationResponse)(value).pipe(Effect.mapError((cause) => controlError(endpoint, "start", cause)));
|
|
287
|
+
});
|
|
288
|
+
const callStopActorObservation = Effect.fn("ActorObservation.stop")(function* (remote, endpoint) {
|
|
289
|
+
yield* remote
|
|
290
|
+
.request({
|
|
291
|
+
endpoint,
|
|
292
|
+
functionName: "StopActorObservation",
|
|
293
|
+
objectPath,
|
|
294
|
+
operation: "observatory.stop_actor_observation",
|
|
295
|
+
parameters: {}
|
|
296
|
+
})
|
|
297
|
+
.pipe(Effect.mapError((cause) => controlError(endpoint, "stop", cause)));
|
|
298
|
+
});
|
|
299
|
+
const requestActorSnapshotForFallback = Effect.fn("ActorObservation.snapshotFallback")(function* (remote, endpoint) {
|
|
300
|
+
const value = yield* remote
|
|
301
|
+
.request({
|
|
302
|
+
endpoint,
|
|
303
|
+
functionName: "GetActorSnapshot",
|
|
304
|
+
objectPath,
|
|
305
|
+
operation: "observatory.actor_snapshot",
|
|
306
|
+
parameters: {}
|
|
307
|
+
})
|
|
308
|
+
.pipe(Effect.mapError((cause) => controlError(endpoint, "status", cause)));
|
|
309
|
+
const response = yield* Schema.decodeUnknownEffect(SnapshotResponse)(value).pipe(Effect.mapError((cause) => controlError(endpoint, "status", cause)));
|
|
310
|
+
if (response.status === "ready")
|
|
311
|
+
return response.snapshot;
|
|
312
|
+
return yield* Effect.fail(new ActorObservationControlError({
|
|
313
|
+
endpoint,
|
|
314
|
+
message: response.message,
|
|
315
|
+
operation: "status",
|
|
316
|
+
retrySafe: true
|
|
317
|
+
}));
|
|
318
|
+
});
|
|
319
|
+
function buildCatalogFromReady(response, endpoint) {
|
|
320
|
+
return Effect.try({
|
|
321
|
+
try: () => {
|
|
322
|
+
const sessionId = ObservationSessionId.make(response.sessionId);
|
|
323
|
+
const revision = CatalogRevision.make(BigInt(response.catalogRevision));
|
|
324
|
+
return catalogFromWireEntries({
|
|
325
|
+
actors: response.catalog.actors,
|
|
326
|
+
capturedAt: response.catalog.capturedAt,
|
|
327
|
+
mapPath: response.catalog.mapPath,
|
|
328
|
+
revision,
|
|
329
|
+
sessionId,
|
|
330
|
+
worldKind: response.catalog.worldKind,
|
|
331
|
+
worldSeconds: response.catalog.worldSeconds
|
|
332
|
+
});
|
|
333
|
+
},
|
|
334
|
+
catch: (cause) => new ActorObservationControlError({
|
|
335
|
+
endpoint,
|
|
336
|
+
message: `Invalid StartActorObservation catalog: ${String(cause)}`,
|
|
337
|
+
operation: "start",
|
|
338
|
+
retrySafe: false
|
|
339
|
+
})
|
|
340
|
+
});
|
|
341
|
+
}
|
|
342
|
+
function runLiveAttempt(args) {
|
|
343
|
+
return Effect.gen(function* () {
|
|
344
|
+
let outcome = {
|
|
345
|
+
_tag: "rejected_exhausted",
|
|
346
|
+
expectedSessionId: undefined,
|
|
347
|
+
reason: "no_catalog",
|
|
348
|
+
receivedSessionId: undefined
|
|
349
|
+
};
|
|
350
|
+
let consecutiveRejected = 0;
|
|
351
|
+
let previousProducerReplacements = 0;
|
|
352
|
+
yield* Stream.runForEachWhile(args.feed.packets, (packet) => Effect.gen(function* () {
|
|
353
|
+
const applyStarted = performance.now();
|
|
354
|
+
const stateBefore = args.getState();
|
|
355
|
+
const event = packet.reset
|
|
356
|
+
? {
|
|
357
|
+
_tag: "reset",
|
|
358
|
+
message: "The Unreal actor catalog was invalidated.",
|
|
359
|
+
recovery: "Reacquiring a fresh catalog over Remote Control."
|
|
360
|
+
}
|
|
361
|
+
: { _tag: "transforms", batch: actorStreamPacketToTransformBatch(packet) };
|
|
362
|
+
const result = applyWorldObservationEvent(stateBefore, event);
|
|
363
|
+
const decodeApplyMs = packet.decodeDurationMs + performance.now() - applyStarted;
|
|
364
|
+
const priorSequence = stateBefore.status === "live" || stateBefore.status === "stale"
|
|
365
|
+
? stateBefore.sample.lastSequence
|
|
366
|
+
: undefined;
|
|
367
|
+
const missingSequences = priorSequence === undefined || packet.sequence <= priorSequence + 1n
|
|
368
|
+
? 0
|
|
369
|
+
: Number(packet.sequence - priorSequence - 1n);
|
|
370
|
+
const feedMetrics = yield* args.feed.metrics;
|
|
371
|
+
yield* args.publish(result.state);
|
|
372
|
+
yield* recordObservatoryPacket({
|
|
373
|
+
actorsChanged: packet.actorsChanged,
|
|
374
|
+
actorsSampled: packet.actorsSampled,
|
|
375
|
+
bytes: ACTOR_STREAM_HEADER_BYTES +
|
|
376
|
+
packet.records.length * ACTOR_STREAM_RECORD_BYTES,
|
|
377
|
+
decodeApplyMs,
|
|
378
|
+
producerReplacements: Math.max(0, packet.producerReplacements - previousProducerReplacements),
|
|
379
|
+
sequenceGap: result.sequenceGap
|
|
380
|
+
});
|
|
381
|
+
previousProducerReplacements = Math.max(previousProducerReplacements, packet.producerReplacements);
|
|
382
|
+
if (args.onDiagnostic !== undefined && result.accepted && !packet.reset) {
|
|
383
|
+
yield* args.onDiagnostic({
|
|
384
|
+
actorsChanged: packet.actorsChanged,
|
|
385
|
+
actorsSampled: packet.actorsSampled,
|
|
386
|
+
decodeApplyMs,
|
|
387
|
+
missingSequences,
|
|
388
|
+
producerReplacements: packet.producerReplacements,
|
|
389
|
+
receiverReplacements: feedMetrics.deliveryReplacements,
|
|
390
|
+
samplingDurationMicros: packet.samplingDurationMicros,
|
|
391
|
+
sequence: packet.sequence
|
|
392
|
+
});
|
|
393
|
+
}
|
|
394
|
+
if (packet.reset) {
|
|
395
|
+
outcome = { _tag: "reset" };
|
|
396
|
+
return false;
|
|
397
|
+
}
|
|
398
|
+
if (result.accepted) {
|
|
399
|
+
consecutiveRejected = 0;
|
|
400
|
+
return true;
|
|
401
|
+
}
|
|
402
|
+
consecutiveRejected += 1;
|
|
403
|
+
if (consecutiveRejected >= args.maxConsecutiveRejectedBatches) {
|
|
404
|
+
const reason = result.reason ?? "no_catalog";
|
|
405
|
+
const expectedSessionId = stateBefore.status === "live" || stateBefore.status === "stale"
|
|
406
|
+
? stateBefore.sample.catalog.sessionId
|
|
407
|
+
: undefined;
|
|
408
|
+
const receivedSessionId = event._tag === "transforms" ? event.batch.sessionId : undefined;
|
|
409
|
+
outcome = {
|
|
410
|
+
_tag: "rejected_exhausted",
|
|
411
|
+
expectedSessionId,
|
|
412
|
+
receivedSessionId,
|
|
413
|
+
reason
|
|
414
|
+
};
|
|
415
|
+
return false;
|
|
416
|
+
}
|
|
417
|
+
return true;
|
|
418
|
+
}));
|
|
419
|
+
return outcome;
|
|
420
|
+
});
|
|
421
|
+
}
|
|
422
|
+
function runPollingFallback(args) {
|
|
423
|
+
const effectiveHz = Math.min(Math.max(1, Math.round(args.cadenceHz)), 10);
|
|
424
|
+
const tick = requestActorSnapshotForFallback(args.remote, args.endpoint).pipe(Effect.matchEffect({
|
|
425
|
+
onFailure: (error) => args.publish(applyWorldObservationEvent(connectingState(), {
|
|
426
|
+
_tag: "unavailable",
|
|
427
|
+
message: error.message,
|
|
428
|
+
recovery: "Reacquire named-pipe observation once the editor is reachable again."
|
|
429
|
+
}).state),
|
|
430
|
+
onSuccess: (snapshot) => args.publish({
|
|
431
|
+
status: "polling_fallback",
|
|
432
|
+
cadenceHz: effectiveHz,
|
|
433
|
+
message: "Named-pipe observation is unavailable on this host.",
|
|
434
|
+
snapshot
|
|
435
|
+
})
|
|
436
|
+
}));
|
|
437
|
+
return Effect.repeat(tick, Schedule.spaced(Duration.millis(1_000 / effectiveHz))).pipe(Effect.andThen(Effect.never));
|
|
438
|
+
}
|
|
439
|
+
function driveObservation(args) {
|
|
440
|
+
const { cadenceHz, capacity, endpoint, getState, maxConsecutiveRejectedBatches, maxMalformedPackets, maxRecoveryAttempts, overridePipeName, onDiagnostic, publish, remote } = args;
|
|
441
|
+
return Effect.gen(function* () {
|
|
442
|
+
let feed;
|
|
443
|
+
let boundPipeName;
|
|
444
|
+
let attempts = 0;
|
|
445
|
+
const backoff = (attempt) => Effect.sleep(Duration.millis(Math.min(200 * 2 ** Math.max(0, attempt - 1), 5_000)));
|
|
446
|
+
const publishUnavailable = (message, recovery) => publish(applyWorldObservationEvent(getState(), { _tag: "unavailable", message, recovery })
|
|
447
|
+
.state);
|
|
448
|
+
const attemptFailed = (message) => Effect.gen(function* () {
|
|
449
|
+
attempts += 1;
|
|
450
|
+
if (attempts > maxRecoveryAttempts) {
|
|
451
|
+
return yield* Effect.fail(new ActorObservationRecoveryExhaustedError({
|
|
452
|
+
attempts: attempts - 1,
|
|
453
|
+
endpoint,
|
|
454
|
+
message
|
|
455
|
+
}));
|
|
456
|
+
}
|
|
457
|
+
yield* publishUnavailable(message, "Retrying actor observation negotiation.");
|
|
458
|
+
yield* backoff(attempts);
|
|
459
|
+
});
|
|
460
|
+
while (true) {
|
|
461
|
+
const startOutcome = yield* Effect.result(callStartActorObservation(remote, endpoint, cadenceHz));
|
|
462
|
+
if (Result.isFailure(startOutcome)) {
|
|
463
|
+
yield* attemptFailed(startOutcome.failure.message);
|
|
464
|
+
continue;
|
|
465
|
+
}
|
|
466
|
+
const startResponse = startOutcome.success;
|
|
467
|
+
if (startResponse.status === "not_supported") {
|
|
468
|
+
yield* publishUnavailable(startResponse.message, startResponse.recovery);
|
|
469
|
+
return yield* runPollingFallback({ cadenceHz, endpoint, publish, remote });
|
|
470
|
+
}
|
|
471
|
+
if (startResponse.status === "failed") {
|
|
472
|
+
yield* attemptFailed(startResponse.message);
|
|
473
|
+
continue;
|
|
474
|
+
}
|
|
475
|
+
const catalogOutcome = yield* Effect.result(buildCatalogFromReady(startResponse, endpoint));
|
|
476
|
+
if (Result.isFailure(catalogOutcome)) {
|
|
477
|
+
yield* attemptFailed(catalogOutcome.failure.message);
|
|
478
|
+
continue;
|
|
479
|
+
}
|
|
480
|
+
const built = catalogOutcome.success;
|
|
481
|
+
const pipeName = overridePipeName ?? startResponse.pipeName;
|
|
482
|
+
if (feed === undefined) {
|
|
483
|
+
const feedOutcome = yield* Effect.result(acquireActorFeedScoped({ capacity, maxMalformedPackets, pipeName }));
|
|
484
|
+
if (Result.isFailure(feedOutcome)) {
|
|
485
|
+
yield* attemptFailed(feedOutcome.failure.message);
|
|
486
|
+
continue;
|
|
487
|
+
}
|
|
488
|
+
feed = feedOutcome.success;
|
|
489
|
+
boundPipeName = pipeName;
|
|
490
|
+
}
|
|
491
|
+
else if (boundPipeName !== pipeName) {
|
|
492
|
+
yield* attemptFailed(`Actor observation pipe name changed from ${boundPipeName} to ${pipeName}; a single feed cannot rebind mid-session.`);
|
|
493
|
+
continue;
|
|
494
|
+
}
|
|
495
|
+
const installed = applyWorldObservationEvent(getState(), {
|
|
496
|
+
_tag: "catalog",
|
|
497
|
+
catalog: built.catalog,
|
|
498
|
+
initialTransforms: built.transforms
|
|
499
|
+
});
|
|
500
|
+
yield* publish(installed.state);
|
|
501
|
+
const liveOutcome = yield* runLiveAttempt({
|
|
502
|
+
feed,
|
|
503
|
+
getState,
|
|
504
|
+
maxConsecutiveRejectedBatches,
|
|
505
|
+
publish,
|
|
506
|
+
...(onDiagnostic === undefined ? {} : { onDiagnostic })
|
|
507
|
+
});
|
|
508
|
+
if (liveOutcome._tag === "reset") {
|
|
509
|
+
// Unreal-initiated catalog invalidation (map change, actor add/delete) is expected
|
|
510
|
+
// during ordinary editor use; it does not consume the bounded recovery budget.
|
|
511
|
+
attempts = 0;
|
|
512
|
+
continue;
|
|
513
|
+
}
|
|
514
|
+
if (liveOutcome.reason === "wrong_session") {
|
|
515
|
+
attempts += 1;
|
|
516
|
+
if (attempts > maxRecoveryAttempts) {
|
|
517
|
+
return yield* Effect.fail(new ActorObservationSessionError({
|
|
518
|
+
endpoint,
|
|
519
|
+
expectedSessionId: liveOutcome.expectedSessionId ?? "",
|
|
520
|
+
message: `Actor observation kept receiving packets for the wrong session after ${attempts - 1} recovery attempts.`,
|
|
521
|
+
receivedSessionId: liveOutcome.receivedSessionId ?? ""
|
|
522
|
+
}));
|
|
523
|
+
}
|
|
524
|
+
yield* publishUnavailable("Actor observation packets did not match the negotiated session.", "Retrying actor observation negotiation.");
|
|
525
|
+
yield* backoff(attempts);
|
|
526
|
+
continue;
|
|
527
|
+
}
|
|
528
|
+
yield* attemptFailed(`Actor observation packets were rejected (${liveOutcome.reason}).`);
|
|
529
|
+
}
|
|
530
|
+
});
|
|
531
|
+
}
|
|
532
|
+
/**
|
|
533
|
+
* Own the full observation lifecycle: negotiate `StartActorObservation`, install/reacquire
|
|
534
|
+
* catalogs, decode and apply transform packets, recover from reset/session faults with a bounded
|
|
535
|
+
* attempt budget, and always call `StopActorObservation` when the returned stream's scope closes.
|
|
536
|
+
*/
|
|
537
|
+
export function observeActorFeed(remote, endpoint, options) {
|
|
538
|
+
return Stream.scoped(Stream.unwrap(Effect.gen(function* () {
|
|
539
|
+
const capacity = options.capacity ?? 16;
|
|
540
|
+
let currentState = connectingState();
|
|
541
|
+
const statePubSub = yield* PubSub.sliding({
|
|
542
|
+
capacity,
|
|
543
|
+
replay: 1
|
|
544
|
+
});
|
|
545
|
+
const publish = (next) => Effect.sync(() => {
|
|
546
|
+
currentState = next;
|
|
547
|
+
}).pipe(Effect.andThen(PubSub.publish(statePubSub, next)), Effect.asVoid);
|
|
548
|
+
yield* publish(currentState);
|
|
549
|
+
yield* Effect.addFinalizer(() => callStopActorObservation(remote, endpoint).pipe(Effect.ignore, Effect.andThen(PubSub.shutdown(statePubSub))));
|
|
550
|
+
const driver = Effect.scoped(driveObservation({
|
|
551
|
+
cadenceHz: options.cadenceHz,
|
|
552
|
+
capacity,
|
|
553
|
+
endpoint,
|
|
554
|
+
getState: () => currentState,
|
|
555
|
+
maxConsecutiveRejectedBatches: options.maxConsecutiveRejectedBatches ?? 64,
|
|
556
|
+
maxMalformedPackets: options.maxMalformedPackets ?? 128,
|
|
557
|
+
maxRecoveryAttempts: options.maxRecoveryAttempts ?? 5,
|
|
558
|
+
onDiagnostic: options.onDiagnostic,
|
|
559
|
+
overridePipeName: options.pipeName,
|
|
560
|
+
publish,
|
|
561
|
+
remote
|
|
562
|
+
}));
|
|
563
|
+
return Stream.fromPubSub(statePubSub).pipe(Stream.mergeEffect(driver));
|
|
564
|
+
})));
|
|
565
|
+
}
|
|
566
|
+
//# sourceMappingURL=actor-feed.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"actor-feed.js","sourceRoot":"","sources":["../src/actor-feed.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,6 @@
|
|
|
1
|
+
import { type ActorId as ActorIdType, type ObservedActor as ObservedActorType } from "./actor-models.js";
|
|
2
|
+
/** Stable key across editor ↔ PIE path prefixes for the same placed instance. */
|
|
3
|
+
export declare function actorInstanceKey(actor: Pick<ObservedActorType, "className" | "path">): string;
|
|
4
|
+
/** Keep a scout selection when snapshot actor ids change (PLAY start/stop). */
|
|
5
|
+
export declare function remapObservedActorId(previousId: ActorIdType | undefined, previousActors: ReadonlyArray<ObservedActorType>, nextActors: ReadonlyArray<ObservedActorType>): ActorIdType | undefined;
|
|
6
|
+
//# sourceMappingURL=actor-identity.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"actor-identity.d.ts","sourceRoot":"","sources":["../src/actor-identity.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,KAAK,OAAO,IAAI,WAAW,EAC3B,KAAK,aAAa,IAAI,iBAAiB,EACvC,MAAM,mBAAmB,CAAC;AAE3B,iFAAiF;AACjF,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,IAAI,CAAC,iBAAiB,EAAE,WAAW,GAAG,MAAM,CAAC,GAAG,MAAM,CAM7F;AAED,+EAA+E;AAC/E,wBAAgB,oBAAoB,CACnC,UAAU,EAAE,WAAW,GAAG,SAAS,EACnC,cAAc,EAAE,aAAa,CAAC,iBAAiB,CAAC,EAChD,UAAU,EAAE,aAAa,CAAC,iBAAiB,CAAC,GAC1C,WAAW,GAAG,SAAS,CAOzB"}
|
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
import {} from "./actor-models.js";
|
|
2
|
+
/** Stable key across editor ↔ PIE path prefixes for the same placed instance. */
|
|
3
|
+
export function actorInstanceKey(actor) {
|
|
4
|
+
const leaf = actor.path.split(".").at(-1) ?? actor.path;
|
|
5
|
+
const persistent = leaf.includes("PersistentLevel.")
|
|
6
|
+
? leaf.slice(leaf.indexOf("PersistentLevel.") + "PersistentLevel.".length)
|
|
7
|
+
: leaf.replace(/^UEDPIE_\d+_/, "");
|
|
8
|
+
return `${actor.className}:${persistent}`;
|
|
9
|
+
}
|
|
10
|
+
/** Keep a scout selection when snapshot actor ids change (PLAY start/stop). */
|
|
11
|
+
export function remapObservedActorId(previousId, previousActors, nextActors) {
|
|
12
|
+
if (previousId === undefined)
|
|
13
|
+
return undefined;
|
|
14
|
+
if (nextActors.some((actor) => actor.id === previousId))
|
|
15
|
+
return previousId;
|
|
16
|
+
const prior = previousActors.find((actor) => actor.id === previousId);
|
|
17
|
+
if (prior === undefined)
|
|
18
|
+
return undefined;
|
|
19
|
+
const key = actorInstanceKey(prior);
|
|
20
|
+
return nextActors.find((actor) => actorInstanceKey(actor) === key)?.id;
|
|
21
|
+
}
|
|
22
|
+
//# sourceMappingURL=actor-identity.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"actor-identity.js","sourceRoot":"","sources":["../src/actor-identity.ts"],"names":[],"mappings":"AAAA,OAAO,EAGN,MAAM,mBAAmB,CAAC;AAE3B,iFAAiF;AACjF,MAAM,UAAU,gBAAgB,CAAC,KAAoD;IACpF,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC;IACxD,MAAM,UAAU,GAAG,IAAI,CAAC,QAAQ,CAAC,kBAAkB,CAAC;QACnD,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,kBAAkB,CAAC,GAAG,kBAAkB,CAAC,MAAM,CAAC;QAC1E,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC;IACpC,OAAO,GAAG,KAAK,CAAC,SAAS,IAAI,UAAU,EAAE,CAAC;AAC3C,CAAC;AAED,+EAA+E;AAC/E,MAAM,UAAU,oBAAoB,CACnC,UAAmC,EACnC,cAAgD,EAChD,UAA4C;IAE5C,IAAI,UAAU,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC/C,IAAI,UAAU,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,KAAK,UAAU,CAAC;QAAE,OAAO,UAAU,CAAC;IAC3E,MAAM,KAAK,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,KAAK,UAAU,CAAC,CAAC;IACtE,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC1C,MAAM,GAAG,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAC;IACpC,OAAO,UAAU,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,gBAAgB,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,EAAE,EAAE,CAAC;AACxE,CAAC"}
|