@camstack/addon-pipeline-orchestrator 1.1.14 → 1.1.15
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/dist/_stub.js +2 -2
- package/dist/{_virtual_mf-localSharedImportMap___mfe_internal__addon_pipeline_orchestrator_widgets-wXpruvsb.mjs → _virtual_mf-localSharedImportMap___mfe_internal__addon_pipeline_orchestrator_widgets-9JducZh4.mjs} +2 -2
- package/dist/_virtual_mf___mfe_internal__addon_pipeline_orchestrator_widgets__loadShare___mf_0_camstack_mf_1_types__loadShare__.js-CEVTusPn.mjs +26 -0
- package/dist/{_virtual_mf___mfe_internal__addon_pipeline_orchestrator_widgets__loadShare___mf_0_camstack_mf_1_ui_mf_2_library__loadShare__.js-D5WB-hDc.mjs → _virtual_mf___mfe_internal__addon_pipeline_orchestrator_widgets__loadShare___mf_0_camstack_mf_1_ui_mf_2_library__loadShare__.js-sANx-U6O.mjs} +1 -1
- package/dist/{hostInit-CjgkznUo.mjs → hostInit-Dh1lreoG.mjs} +2 -2
- package/dist/index.js +1557 -940
- package/dist/index.mjs +1557 -940
- package/dist/remoteEntry.js +1 -1
- package/package.json +1 -1
- package/dist/_virtual_mf___mfe_internal__addon_pipeline_orchestrator_widgets__loadShare___mf_0_camstack_mf_1_types__loadShare__.js-yz7hJdXe.mjs +0 -26
package/dist/index.js
CHANGED
|
@@ -4631,7 +4631,7 @@ function _instanceof(cls, params = {}) {
|
|
|
4631
4631
|
return inst;
|
|
4632
4632
|
}
|
|
4633
4633
|
//#endregion
|
|
4634
|
-
//#region ../types/dist/sleep-
|
|
4634
|
+
//#region ../types/dist/sleep-MHm--th-.mjs
|
|
4635
4635
|
var EventCategory = /* @__PURE__ */ function(EventCategory) {
|
|
4636
4636
|
EventCategory["SystemBoot"] = "system.boot";
|
|
4637
4637
|
EventCategory["SystemAddonsReady"] = "system.addons-ready";
|
|
@@ -5909,6 +5909,7 @@ var CamStreamKindSchema = _enum([
|
|
|
5909
5909
|
"pull-rtsp",
|
|
5910
5910
|
"pull-rtmp",
|
|
5911
5911
|
"pull-http",
|
|
5912
|
+
"pull-flv",
|
|
5912
5913
|
"pull-rfc4571",
|
|
5913
5914
|
"push-annexb",
|
|
5914
5915
|
"derived"
|
|
@@ -14000,7 +14001,7 @@ var AddBrokerInputSchema = object({
|
|
|
14000
14001
|
});
|
|
14001
14002
|
var AddBrokerResultSchema = object({ id: string() });
|
|
14002
14003
|
var IdInputSchema = object({ id: string() });
|
|
14003
|
-
var TestResultSchema = discriminatedUnion("ok", [object({
|
|
14004
|
+
var TestResultSchema$1 = discriminatedUnion("ok", [object({
|
|
14004
14005
|
ok: literal(true),
|
|
14005
14006
|
latencyMs: number()
|
|
14006
14007
|
}), object({
|
|
@@ -14023,7 +14024,7 @@ var StatusSchema = object({
|
|
|
14023
14024
|
brokerCount: number(),
|
|
14024
14025
|
embeddedRunning: boolean()
|
|
14025
14026
|
});
|
|
14026
|
-
method(_void(), array(BrokerInfoSchema)), method(IdInputSchema, BrokerConnectionDetailsSchema), method(AddBrokerInputSchema, AddBrokerResultSchema, { kind: "mutation" }), method(IdInputSchema, _void(), { kind: "mutation" }), method(IdInputSchema, TestResultSchema, { kind: "mutation" }), method(StartEmbeddedInputSchema, StartEmbeddedResultSchema, { kind: "mutation" }), method(IdInputSchema, _void(), { kind: "mutation" }), method(_void(), StatusSchema);
|
|
14027
|
+
method(_void(), array(BrokerInfoSchema)), method(IdInputSchema, BrokerConnectionDetailsSchema), method(AddBrokerInputSchema, AddBrokerResultSchema, { kind: "mutation" }), method(IdInputSchema, _void(), { kind: "mutation" }), method(IdInputSchema, TestResultSchema$1, { kind: "mutation" }), method(StartEmbeddedInputSchema, StartEmbeddedResultSchema, { kind: "mutation" }), method(IdInputSchema, _void(), { kind: "mutation" }), method(_void(), StatusSchema);
|
|
14027
14028
|
var NetworkEndpointSchema = object({
|
|
14028
14029
|
url: string(),
|
|
14029
14030
|
hostname: string(),
|
|
@@ -14057,23 +14058,198 @@ var NetworkEndpointEntrySchema = NetworkEndpointSchema.extend({
|
|
|
14057
14058
|
sourcePort: number().optional()
|
|
14058
14059
|
});
|
|
14059
14060
|
method(_void(), NetworkEndpointSchema, { kind: "mutation" }), method(_void(), _void(), { kind: "mutation" }), method(_void(), NetworkEndpointSchema.nullable()), method(_void(), NetworkAccessStatusSchema), method(_void(), array(NetworkEndpointEntrySchema).readonly());
|
|
14060
|
-
|
|
14061
|
-
|
|
14061
|
+
/**
|
|
14062
|
+
* notification-output — canonical, capability-gated notification delivery.
|
|
14063
|
+
*
|
|
14064
|
+
* Apprise-derived model (see
|
|
14065
|
+
* `docs/superpowers/specs/2026-07-03-notification-output-notifier-matrix.md`):
|
|
14066
|
+
* callers emit ONE canonical `Notification`; each provider declares a
|
|
14067
|
+
* per-kind capability descriptor (`TargetKind`), and the pure degrade
|
|
14068
|
+
* engine (`@camstack/types` `prepareNotification`) transcodes / degrades the
|
|
14069
|
+
* message to what the kind supports — callers never special-case a service.
|
|
14070
|
+
*
|
|
14071
|
+
* DESIGN DECISIONS (locked):
|
|
14072
|
+
* - Target CRUD lives on THIS cap (`upsertTarget` / `deleteTarget` /
|
|
14073
|
+
* `setTargetEnabled`), each provider persisting via the `settings-store`
|
|
14074
|
+
* cap. Rationale: the admin UI needs one uniform surface across the
|
|
14075
|
+
* notifiers addon AND the HA addon; the addon-`globalSettingsSchema`-array
|
|
14076
|
+
* alternative would fork the UI per addon and cannot host the
|
|
14077
|
+
* discovery→adopt flow.
|
|
14078
|
+
* - `listTargetKinds` / `listTargets` / `discoverTargets` return arrays →
|
|
14079
|
+
* the generated cap-mount auto-`concatCollection`-fans them across every
|
|
14080
|
+
* registered provider (notifiers addon + HA addon) so one catalog is
|
|
14081
|
+
* routable. `send` / `testTarget` / CRUD route to ONE provider by the
|
|
14082
|
+
* `addonId` the generated collection router extracts from the call input.
|
|
14083
|
+
* - `Attachment.bytes` is `Uint8Array`. Transport-safe: superjson (the tRPC
|
|
14084
|
+
* transformer) + UDS MsgPack both round-trip typed arrays — already used by
|
|
14085
|
+
* `storage` / `storage-provider` / `recording` caps over the same path. No
|
|
14086
|
+
* base64 fallback needed.
|
|
14087
|
+
*
|
|
14088
|
+
* TODO (deferred, closed-set change — separate decision): add
|
|
14089
|
+
* `providerKind: 'notify'` so notification providers surface on the unified
|
|
14090
|
+
* admin "Integrations" page.
|
|
14091
|
+
*/
|
|
14092
|
+
/**
|
|
14093
|
+
* Zentik-derived typed-media enum — the superset across every kind. Each
|
|
14094
|
+
* adapter picks what it supports and the degrade engine filters the rest.
|
|
14095
|
+
*/
|
|
14096
|
+
var AttachmentMediaTypeSchema = _enum([
|
|
14097
|
+
"image",
|
|
14098
|
+
"video",
|
|
14099
|
+
"gif",
|
|
14100
|
+
"audio",
|
|
14101
|
+
"icon"
|
|
14102
|
+
]);
|
|
14103
|
+
/**
|
|
14104
|
+
* A single attachment. Exactly one of `url` (remote source, most adapters
|
|
14105
|
+
* prefer this) or `bytes` (inline source; required for Pushover-style
|
|
14106
|
+
* bytes-only kinds) MUST be present — the degrade engine expresses a
|
|
14107
|
+
* url→bytes fetch as a `needsFetch` directive the adapter executes.
|
|
14108
|
+
*/
|
|
14109
|
+
var AttachmentSchema = object({
|
|
14110
|
+
mediaType: AttachmentMediaTypeSchema,
|
|
14111
|
+
url: string().optional(),
|
|
14112
|
+
bytes: _instanceof(Uint8Array).optional(),
|
|
14113
|
+
mime: string().optional(),
|
|
14114
|
+
name: string().optional()
|
|
14115
|
+
}).refine((a) => a.url !== void 0 || a.bytes !== void 0, { message: "Attachment requires either `url` or `bytes`" });
|
|
14116
|
+
var NotificationFormatSchema = _enum([
|
|
14117
|
+
"text",
|
|
14118
|
+
"markdown",
|
|
14119
|
+
"html"
|
|
14120
|
+
]);
|
|
14121
|
+
/** A single tap-through action button. */
|
|
14122
|
+
var NotificationActionSchema = object({
|
|
14123
|
+
id: string(),
|
|
14124
|
+
label: string(),
|
|
14125
|
+
url: string().optional()
|
|
14126
|
+
});
|
|
14127
|
+
/**
|
|
14128
|
+
* The canonical notification. `body` is the only hard field (Apprise model).
|
|
14129
|
+
* `priority` is a 5-level ORDINAL (1=lowest … 3=normal(default) … 5=urgent),
|
|
14130
|
+
* NOT a fixed severity enum — each kind declares its own `caps.levels` and
|
|
14131
|
+
* the adapter maps this ordinal onto its native level. `level?` is an
|
|
14132
|
+
* optional kind-native level id (`emergency`, `silent`, …) that overrides
|
|
14133
|
+
* `priority` for that one target.
|
|
14134
|
+
*/
|
|
14135
|
+
var NotificationSchema = object({
|
|
14062
14136
|
body: string(),
|
|
14063
|
-
|
|
14137
|
+
title: string().optional(),
|
|
14138
|
+
format: NotificationFormatSchema.default("text"),
|
|
14139
|
+
priority: number().int().min(1).max(5).default(3),
|
|
14140
|
+
level: string().optional(),
|
|
14141
|
+
attachments: array(AttachmentSchema).optional(),
|
|
14142
|
+
clickUrl: string().optional(),
|
|
14143
|
+
actions: array(NotificationActionSchema).optional(),
|
|
14144
|
+
sound: string().optional(),
|
|
14145
|
+
ttl: number().optional(),
|
|
14146
|
+
tag: string().optional(),
|
|
14064
14147
|
deviceId: number().optional(),
|
|
14065
14148
|
eventId: string().optional(),
|
|
14066
|
-
priority: _enum([
|
|
14067
|
-
"low",
|
|
14068
|
-
"normal",
|
|
14069
|
-
"high",
|
|
14070
|
-
"critical"
|
|
14071
|
-
]).default("normal"),
|
|
14072
14149
|
metadata: record(string(), unknown()).optional()
|
|
14073
|
-
})
|
|
14150
|
+
});
|
|
14151
|
+
/** One declared native severity/priority level for a kind. */
|
|
14152
|
+
var TargetKindLevelSchema = object({
|
|
14153
|
+
id: string(),
|
|
14154
|
+
label: string(),
|
|
14155
|
+
/** Which canonical priority (1..5) this level maps to. `null` = qualitative-only. */
|
|
14156
|
+
ordinal: number().int().min(1).max(5).nullable(),
|
|
14157
|
+
flags: object({
|
|
14158
|
+
critical: boolean().optional(),
|
|
14159
|
+
silent: boolean().optional(),
|
|
14160
|
+
noPush: boolean().optional()
|
|
14161
|
+
}).optional(),
|
|
14162
|
+
/** e.g. Pushover `emergency` requires `retry` / `expire`. */
|
|
14163
|
+
requires: array(string()).optional(),
|
|
14164
|
+
description: string().optional()
|
|
14165
|
+
});
|
|
14166
|
+
/** The full capability block consulted before dispatch. */
|
|
14167
|
+
var TargetKindCapsSchema = object({
|
|
14168
|
+
attachments: object({
|
|
14169
|
+
mediaTypes: array(AttachmentMediaTypeSchema),
|
|
14170
|
+
mode: _enum([
|
|
14171
|
+
"url",
|
|
14172
|
+
"bytes",
|
|
14173
|
+
"both"
|
|
14174
|
+
]),
|
|
14175
|
+
max: number().int().nonnegative(),
|
|
14176
|
+
maxBytes: number().int().positive().optional()
|
|
14177
|
+
}),
|
|
14178
|
+
/** Max action buttons (0 = none). */
|
|
14179
|
+
actions: number().int().nonnegative(),
|
|
14180
|
+
levels: array(TargetKindLevelSchema),
|
|
14181
|
+
format: array(NotificationFormatSchema),
|
|
14182
|
+
clickUrl: boolean(),
|
|
14183
|
+
sound: boolean(),
|
|
14184
|
+
ttl: boolean(),
|
|
14185
|
+
bodyMaxLen: number().int().positive()
|
|
14186
|
+
});
|
|
14187
|
+
/**
|
|
14188
|
+
* `configSchema` is a `ConfigUISchema` tree passed through to the admin
|
|
14189
|
+
* FormBuilder. Stored as `z.unknown()` at the cap seam (mirrors
|
|
14190
|
+
* `device-provider.getChildCreationSchema` `CreationSchemaOutputSchema`) —
|
|
14191
|
+
* the union is large and not meant for runtime validation here; the exported
|
|
14192
|
+
* `TargetKind` type re-tightens `configSchema` to `ConfigUISchema`.
|
|
14193
|
+
*/
|
|
14194
|
+
var ConfigSchemaPassthrough = unknown();
|
|
14195
|
+
var TargetKindSchema = object({
|
|
14196
|
+
kind: string(),
|
|
14197
|
+
label: string(),
|
|
14198
|
+
icon: string(),
|
|
14199
|
+
/** Stamped by each provider so the concat-fanned catalog stays routable. */
|
|
14200
|
+
addonId: string(),
|
|
14201
|
+
configSchema: ConfigSchemaPassthrough,
|
|
14202
|
+
supportsDiscovery: boolean(),
|
|
14203
|
+
caps: TargetKindCapsSchema
|
|
14204
|
+
});
|
|
14205
|
+
/**
|
|
14206
|
+
* A persisted target. `config` holds secrets; providers REDACT secret fields
|
|
14207
|
+
* (return a presence marker only) when serving `listTargets` — never
|
|
14208
|
+
* round-trip a stored secret to the UI.
|
|
14209
|
+
*/
|
|
14210
|
+
var TargetSchema = object({
|
|
14211
|
+
id: string(),
|
|
14212
|
+
name: string(),
|
|
14213
|
+
kind: string(),
|
|
14214
|
+
addonId: string(),
|
|
14215
|
+
enabled: boolean(),
|
|
14216
|
+
config: record(string(), unknown())
|
|
14217
|
+
});
|
|
14218
|
+
/** A discovery-surfaced candidate (config is partial + non-secret). */
|
|
14219
|
+
var DiscoveredTargetSchema = object({
|
|
14220
|
+
kind: string(),
|
|
14221
|
+
suggestedName: string(),
|
|
14222
|
+
config: record(string(), unknown())
|
|
14223
|
+
});
|
|
14224
|
+
/** The degrade engine's report — what was resolved / dropped / degraded. */
|
|
14225
|
+
var RenderedAsSchema = object({
|
|
14226
|
+
level: string(),
|
|
14227
|
+
format: NotificationFormatSchema,
|
|
14228
|
+
attachmentsSent: number().int().nonnegative(),
|
|
14229
|
+
actionsSent: number().int().nonnegative(),
|
|
14230
|
+
truncated: boolean(),
|
|
14231
|
+
dropped: array(string())
|
|
14232
|
+
});
|
|
14233
|
+
var SendResultSchema = object({
|
|
14074
14234
|
success: boolean(),
|
|
14075
|
-
error: string().optional()
|
|
14076
|
-
|
|
14235
|
+
error: string().optional(),
|
|
14236
|
+
renderedAs: RenderedAsSchema.optional()
|
|
14237
|
+
});
|
|
14238
|
+
/** Same shape as SendResult — kept as a distinct name for the test panel. */
|
|
14239
|
+
var TestResultSchema = SendResultSchema;
|
|
14240
|
+
method(object({}), array(TargetKindSchema)), method(object({}), array(TargetSchema)), method(object({
|
|
14241
|
+
kind: string(),
|
|
14242
|
+
config: record(string(), unknown()).optional()
|
|
14243
|
+
}), array(DiscoveredTargetSchema)), method(object({
|
|
14244
|
+
targetId: string(),
|
|
14245
|
+
notification: NotificationSchema
|
|
14246
|
+
}), SendResultSchema, { kind: "mutation" }), method(object({
|
|
14247
|
+
targetId: string(),
|
|
14248
|
+
sample: NotificationSchema.optional()
|
|
14249
|
+
}), TestResultSchema, { kind: "mutation" }), method(object({ target: TargetSchema }), TargetSchema, { kind: "mutation" }), method(object({ targetId: string() }), _void(), { kind: "mutation" }), method(object({
|
|
14250
|
+
targetId: string(),
|
|
14251
|
+
enabled: boolean()
|
|
14252
|
+
}), _void(), { kind: "mutation" });
|
|
14077
14253
|
/**
|
|
14078
14254
|
* Zod schemas for persisted record types.
|
|
14079
14255
|
*
|
|
@@ -14863,10 +15039,11 @@ var pipelineOrchestratorCapability = {
|
|
|
14863
15039
|
}))),
|
|
14864
15040
|
/**
|
|
14865
15041
|
* Get one camera's decoder placement (computed if not yet pinned).
|
|
14866
|
-
*
|
|
14867
|
-
*
|
|
14868
|
-
*
|
|
14869
|
-
*
|
|
15042
|
+
*
|
|
15043
|
+
* ADVISORY today: reports the orchestrator's decoder preference only.
|
|
15044
|
+
* Actual decode placement is broker-owned (local-node pin + frame-plane
|
|
15045
|
+
* co-location guard). Reserved to become the binding source/decoder-owner
|
|
15046
|
+
* control in the stream-LB epic (Phase 2).
|
|
14870
15047
|
*
|
|
14871
15048
|
* `pipelineNodeId` is the node already chosen to run inference for
|
|
14872
15049
|
* this camera. When provided, the balancer prefers co-location with
|
|
@@ -20238,13 +20415,49 @@ Object.freeze({
|
|
|
20238
20415
|
addonId: null,
|
|
20239
20416
|
access: "create"
|
|
20240
20417
|
},
|
|
20418
|
+
"notificationOutput.deleteTarget": {
|
|
20419
|
+
capName: "notification-output",
|
|
20420
|
+
capScope: "system",
|
|
20421
|
+
addonId: null,
|
|
20422
|
+
access: "delete"
|
|
20423
|
+
},
|
|
20424
|
+
"notificationOutput.discoverTargets": {
|
|
20425
|
+
capName: "notification-output",
|
|
20426
|
+
capScope: "system",
|
|
20427
|
+
addonId: null,
|
|
20428
|
+
access: "view"
|
|
20429
|
+
},
|
|
20430
|
+
"notificationOutput.listTargetKinds": {
|
|
20431
|
+
capName: "notification-output",
|
|
20432
|
+
capScope: "system",
|
|
20433
|
+
addonId: null,
|
|
20434
|
+
access: "view"
|
|
20435
|
+
},
|
|
20436
|
+
"notificationOutput.listTargets": {
|
|
20437
|
+
capName: "notification-output",
|
|
20438
|
+
capScope: "system",
|
|
20439
|
+
addonId: null,
|
|
20440
|
+
access: "view"
|
|
20441
|
+
},
|
|
20241
20442
|
"notificationOutput.send": {
|
|
20242
20443
|
capName: "notification-output",
|
|
20243
20444
|
capScope: "system",
|
|
20244
20445
|
addonId: null,
|
|
20245
20446
|
access: "create"
|
|
20246
20447
|
},
|
|
20247
|
-
"notificationOutput.
|
|
20448
|
+
"notificationOutput.setTargetEnabled": {
|
|
20449
|
+
capName: "notification-output",
|
|
20450
|
+
capScope: "system",
|
|
20451
|
+
addonId: null,
|
|
20452
|
+
access: "create"
|
|
20453
|
+
},
|
|
20454
|
+
"notificationOutput.testTarget": {
|
|
20455
|
+
capName: "notification-output",
|
|
20456
|
+
capScope: "system",
|
|
20457
|
+
addonId: null,
|
|
20458
|
+
access: "create"
|
|
20459
|
+
},
|
|
20460
|
+
"notificationOutput.upsertTarget": {
|
|
20248
20461
|
capName: "notification-output",
|
|
20249
20462
|
capScope: "system",
|
|
20250
20463
|
addonId: null,
|
|
@@ -22420,470 +22633,232 @@ function buildTreeFromAddons(enabled, catalog) {
|
|
|
22420
22633
|
return roots;
|
|
22421
22634
|
}
|
|
22422
22635
|
//#endregion
|
|
22423
|
-
//#region src/
|
|
22636
|
+
//#region src/audio-chunk-poller.ts
|
|
22424
22637
|
/**
|
|
22425
|
-
* `
|
|
22638
|
+
* `AudioChunkPoller` — the consumer-side poll loop of the decoded audio-chunk
|
|
22639
|
+
* plane (Phase 5 / D9).
|
|
22426
22640
|
*
|
|
22427
|
-
*
|
|
22428
|
-
*
|
|
22429
|
-
*
|
|
22430
|
-
*
|
|
22431
|
-
* pipeline-executor, analytics, admin UI) read the live state with
|
|
22432
|
-
* the canonical `dev.state.zones.onChanged` channel.
|
|
22641
|
+
* Replaces the live-object `IStreamBroker.onDecodedAudioChunk(cb)` callback
|
|
22642
|
+
* path. A live callback cannot cross a process boundary; once the `pipeline`
|
|
22643
|
+
* group is dissolved (Task 8) the orchestrator runs in a different process
|
|
22644
|
+
* from the broker, so audio delivery must go over tRPC.
|
|
22433
22645
|
*
|
|
22434
|
-
*
|
|
22435
|
-
* zone is operator-drawn. The provider keeps the surface symmetric:
|
|
22436
|
-
* `addZone` rejects id collisions, `updateZone` requires an existing
|
|
22437
|
-
* id, `removeZone` is idempotent.
|
|
22438
|
-
*/
|
|
22439
|
-
var ZONES_STORE_KEY = "zones";
|
|
22440
|
-
var ZONES_CAP_NAME = "zones";
|
|
22441
|
-
var ZonesArraySchema = array(ZoneSchema);
|
|
22442
|
-
var ZonesProvider = class {
|
|
22443
|
-
ctx;
|
|
22444
|
-
/** Per-device cache. Hydrated lazily on first read for a device. */
|
|
22445
|
-
cache = /* @__PURE__ */ new Map();
|
|
22446
|
-
/**
|
|
22447
|
-
* Per-device durable handle over the `zones` store key. The WHOLE
|
|
22448
|
-
* validated zone array round-trips on every read/write so no field can
|
|
22449
|
-
* be dropped on persist. Built lazily + memoised per device.
|
|
22450
|
-
*/
|
|
22451
|
-
stateByDevice = /* @__PURE__ */ new Map();
|
|
22452
|
-
constructor(ctx) {
|
|
22453
|
-
this.ctx = ctx;
|
|
22454
|
-
}
|
|
22455
|
-
/** Lazily build (and memoise) the durable `zones` handle for a device. */
|
|
22456
|
-
zonesState(deviceId) {
|
|
22457
|
-
let handle = this.stateByDevice.get(deviceId);
|
|
22458
|
-
if (!handle) {
|
|
22459
|
-
handle = createDurableState({
|
|
22460
|
-
key: ZONES_STORE_KEY,
|
|
22461
|
-
schema: ZonesArraySchema,
|
|
22462
|
-
fallback: [],
|
|
22463
|
-
read: () => this.ctx.settings.readDeviceStore(deviceId),
|
|
22464
|
-
write: (patch) => this.ctx.settings.writeDeviceStore(deviceId, patch),
|
|
22465
|
-
onParseError: (key, error) => this.ctx.logger.warn("zones store entry failed to parse — resetting", {
|
|
22466
|
-
tags: { deviceId },
|
|
22467
|
-
meta: {
|
|
22468
|
-
key,
|
|
22469
|
-
error: error instanceof Error ? error.message : String(error)
|
|
22470
|
-
}
|
|
22471
|
-
})
|
|
22472
|
-
});
|
|
22473
|
-
this.stateByDevice.set(deviceId, handle);
|
|
22474
|
-
}
|
|
22475
|
-
return handle;
|
|
22476
|
-
}
|
|
22477
|
-
async listZones({ deviceId }) {
|
|
22478
|
-
return this.loadZones(deviceId);
|
|
22479
|
-
}
|
|
22480
|
-
async addZone({ deviceId, zone }) {
|
|
22481
|
-
const existing = await this.loadZones(deviceId);
|
|
22482
|
-
if (existing.some((entry) => entry.id === zone.id)) throw new Error(`zones.addZone: id ${zone.id} already exists`);
|
|
22483
|
-
await this.persist(deviceId, [...existing, zone]);
|
|
22484
|
-
}
|
|
22485
|
-
async updateZone({ deviceId, zone }) {
|
|
22486
|
-
const existing = await this.loadZones(deviceId);
|
|
22487
|
-
if (!existing.some((entry) => entry.id === zone.id)) throw new Error(`zones.updateZone: id ${zone.id} not found`);
|
|
22488
|
-
const next = existing.map((entry) => entry.id === zone.id ? zone : entry);
|
|
22489
|
-
await this.persist(deviceId, next);
|
|
22490
|
-
}
|
|
22491
|
-
async removeZone({ deviceId, zoneId }) {
|
|
22492
|
-
const existing = await this.loadZones(deviceId);
|
|
22493
|
-
if (!existing.some((entry) => entry.id === zoneId)) return;
|
|
22494
|
-
await this.persist(deviceId, existing.filter((entry) => entry.id !== zoneId));
|
|
22495
|
-
}
|
|
22496
|
-
/**
|
|
22497
|
-
* Drop a device's cache entry. Called when the device is removed so
|
|
22498
|
-
* the next attach starts from a fresh disk read.
|
|
22499
|
-
*/
|
|
22500
|
-
forgetDevice(deviceId) {
|
|
22501
|
-
this.cache.delete(deviceId);
|
|
22502
|
-
this.stateByDevice.delete(deviceId);
|
|
22503
|
-
}
|
|
22504
|
-
async loadZones(deviceId) {
|
|
22505
|
-
const cached = this.cache.get(deviceId);
|
|
22506
|
-
if (cached) return cached;
|
|
22507
|
-
let zones = [];
|
|
22508
|
-
try {
|
|
22509
|
-
zones = await this.zonesState(deviceId).get();
|
|
22510
|
-
} catch (err) {
|
|
22511
|
-
this.ctx.logger.warn("zones store read failed — using empty list", {
|
|
22512
|
-
tags: { deviceId },
|
|
22513
|
-
meta: { error: err instanceof Error ? err.message : String(err) }
|
|
22514
|
-
});
|
|
22515
|
-
}
|
|
22516
|
-
this.cache.set(deviceId, zones);
|
|
22517
|
-
return zones;
|
|
22518
|
-
}
|
|
22519
|
-
async persist(deviceId, zones) {
|
|
22520
|
-
this.cache.set(deviceId, zones);
|
|
22521
|
-
await this.zonesState(deviceId).set(zones);
|
|
22522
|
-
await (await this.ctx.fetchDevice(deviceId)).deviceState.setCapSlice({
|
|
22523
|
-
capName: ZONES_CAP_NAME,
|
|
22524
|
-
slice: { zones }
|
|
22525
|
-
});
|
|
22526
|
-
this.ctx.onZonesChanged?.(deviceId, zones);
|
|
22527
|
-
}
|
|
22528
|
-
};
|
|
22529
|
-
//#endregion
|
|
22530
|
-
//#region src/zone-rules-provider.ts
|
|
22531
|
-
/**
|
|
22532
|
-
* `zone-rules-provider.ts` — implements `zoneRulesCapability` for the
|
|
22533
|
-
* orchestrator.
|
|
22646
|
+
* The consumer:
|
|
22534
22647
|
*
|
|
22535
|
-
*
|
|
22536
|
-
*
|
|
22537
|
-
*
|
|
22538
|
-
* (
|
|
22539
|
-
*
|
|
22540
|
-
*
|
|
22648
|
+
* 1. `subscribeAudioChunks({ brokerId, tag })` over tRPC — the broker
|
|
22649
|
+
* registers a per-subscription bounded FIFO queue and returns a
|
|
22650
|
+
* `subscriptionId`;
|
|
22651
|
+
* 2. polls `pullAudioChunks({ subscriptionId, maxCount })` on a modest
|
|
22652
|
+
* interval, draining `DecodedAudioChunk`s in FIFO arrival order;
|
|
22653
|
+
* 3. feeds each chunk to its downstream audio logic;
|
|
22654
|
+
* 4. on teardown, `unsubscribeAudioChunks`.
|
|
22541
22655
|
*
|
|
22542
|
-
*
|
|
22543
|
-
*
|
|
22544
|
-
*
|
|
22545
|
-
*
|
|
22656
|
+
* Audio is not latency-critical like video, and chunks arrive only ~every
|
|
22657
|
+
* 500ms (the broker's `AudioCodecSession` window). A modest poll period plus
|
|
22658
|
+
* a small per-poll burst keeps latency low without busy-spinning. The
|
|
22659
|
+
* broker's queue is FIFO/no-drop-sized so a poll-period of jitter never
|
|
22660
|
+
* loses a chunk.
|
|
22661
|
+
*
|
|
22662
|
+
* Boot-race tolerance: the broker for a given camStream may not be registered
|
|
22663
|
+
* yet when the orchestrator wires the subscription (provider addons publish
|
|
22664
|
+
* their cameraStreams asynchronously after their probe completes).
|
|
22665
|
+
* `subscribeAudioChunks` retries with exponential backoff (capped at
|
|
22666
|
+
* `MAX_SUBSCRIBE_RETRY_BACKOFF_MS`) until it succeeds or the returned
|
|
22667
|
+
* teardown closure is invoked. Mirrors the `FrameHandlePoller` recovery
|
|
22668
|
+
* shape so video and audio plumbing self-heal identically.
|
|
22546
22669
|
*/
|
|
22547
|
-
/**
|
|
22548
|
-
|
|
22549
|
-
|
|
22550
|
-
var
|
|
22551
|
-
/**
|
|
22552
|
-
*
|
|
22553
|
-
*
|
|
22554
|
-
*
|
|
22555
|
-
*
|
|
22556
|
-
var ZONE_RULES_CAP_NAME = "zone-rules";
|
|
22557
|
-
var RulesArraySchema = array(ZoneRuleSchema);
|
|
22558
|
-
/**
|
|
22559
|
-
* Whole-blob schema for the per-device `zoneRules` store key. Both stages
|
|
22560
|
-
* travel together under one key. Deliberately lenient — each stage is
|
|
22561
|
-
* `unknown` so a corrupt single stage can NOT drop the sibling on load
|
|
22562
|
-
* (durable-state `get()` falls back to `{}` only on a whole-blob parse
|
|
22563
|
-
* failure). Strict per-stage validation, with its own reset-on-corrupt
|
|
22564
|
-
* warn, still happens in `loadRules` exactly as before the migration.
|
|
22670
|
+
/** Poll period — audio chunks arrive ~every 500ms; 200ms keeps latency low. */
|
|
22671
|
+
var POLL_INTERVAL_MS = 200;
|
|
22672
|
+
/** How many chunks to drain per poll — a small burst absorbs jitter. */
|
|
22673
|
+
var PULL_MAX_COUNT = 8;
|
|
22674
|
+
/**
|
|
22675
|
+
* Consecutive pull failures before we attempt to re-subscribe. A single failed
|
|
22676
|
+
* poll is treated as a blip (re-subscribing would leak a broker-side FIFO); a
|
|
22677
|
+
* sustained failure means the broker child restarted and dropped our
|
|
22678
|
+
* subscription, so we re-establish it.
|
|
22565
22679
|
*/
|
|
22566
|
-
var
|
|
22567
|
-
|
|
22568
|
-
|
|
22569
|
-
|
|
22570
|
-
var
|
|
22571
|
-
|
|
22572
|
-
|
|
22573
|
-
|
|
22574
|
-
|
|
22575
|
-
|
|
22576
|
-
|
|
22577
|
-
|
|
22578
|
-
|
|
22579
|
-
|
|
22580
|
-
|
|
22581
|
-
|
|
22582
|
-
|
|
22583
|
-
|
|
22584
|
-
|
|
22585
|
-
|
|
22586
|
-
|
|
22587
|
-
|
|
22588
|
-
|
|
22589
|
-
|
|
22590
|
-
|
|
22591
|
-
|
|
22592
|
-
|
|
22593
|
-
|
|
22594
|
-
|
|
22595
|
-
|
|
22596
|
-
|
|
22597
|
-
|
|
22598
|
-
}
|
|
22599
|
-
})
|
|
22600
|
-
});
|
|
22601
|
-
this.stateByDevice.set(deviceId, handle);
|
|
22680
|
+
var RESUBSCRIBE_AFTER_FAILURES = 2;
|
|
22681
|
+
/** Re-subscribe at most once every N ticks while failing (~1s at 200ms). */
|
|
22682
|
+
var RESUBSCRIBE_THROTTLE_TICKS = 5;
|
|
22683
|
+
/** First subscribe-retry delay, doubled on every subsequent failure. */
|
|
22684
|
+
var INITIAL_SUBSCRIBE_RETRY_BACKOFF_MS = 250;
|
|
22685
|
+
/**
|
|
22686
|
+
* Subscribe-retry backoff ceiling. 5 s matches the frame-handle poller — fast
|
|
22687
|
+
* enough to recover within a single reconcile of the orchestrator and slow
|
|
22688
|
+
* enough that a misconfigured camStream costs ~12 op/min, not 5/s.
|
|
22689
|
+
*/
|
|
22690
|
+
var MAX_SUBSCRIBE_RETRY_BACKOFF_MS = 5e3;
|
|
22691
|
+
/**
|
|
22692
|
+
* Subscribe to a broker's decoded audio-chunk stream and start the poll loop.
|
|
22693
|
+
*
|
|
22694
|
+
* Always resolves to a teardown closure — when the broker is not yet
|
|
22695
|
+
* registered the closure cancels the ongoing retry loop; when polling is
|
|
22696
|
+
* active it stops the loop and releases the broker subscription. Mirrors
|
|
22697
|
+
* `startFrameHandlePoller` so video and audio recover identically.
|
|
22698
|
+
*/
|
|
22699
|
+
function startAudioChunkPoller(options) {
|
|
22700
|
+
const lifecycle = {
|
|
22701
|
+
stopped: false,
|
|
22702
|
+
retryTimer: void 0,
|
|
22703
|
+
pollTimer: void 0,
|
|
22704
|
+
activeSubscriptionId: null
|
|
22705
|
+
};
|
|
22706
|
+
const teardown = () => {
|
|
22707
|
+
if (lifecycle.stopped) return;
|
|
22708
|
+
lifecycle.stopped = true;
|
|
22709
|
+
if (lifecycle.retryTimer) {
|
|
22710
|
+
clearTimeout(lifecycle.retryTimer);
|
|
22711
|
+
lifecycle.retryTimer = void 0;
|
|
22602
22712
|
}
|
|
22603
|
-
|
|
22604
|
-
|
|
22605
|
-
|
|
22606
|
-
return this.loadRules(deviceId, stage);
|
|
22607
|
-
}
|
|
22608
|
-
async setRules({ deviceId, stage, rules }) {
|
|
22609
|
-
const parsed = RulesArraySchema.safeParse(rules);
|
|
22610
|
-
if (!parsed.success) throw new Error(`zone-rules.setRules: invalid rule payload — ${parsed.error.issues.map((i) => i.message).join("; ")}`);
|
|
22611
|
-
await this.persist(deviceId, stage, parsed.data);
|
|
22612
|
-
}
|
|
22613
|
-
/** Drop a device's cache entries. Called when the device is removed. */
|
|
22614
|
-
forgetDevice(deviceId) {
|
|
22615
|
-
this.cache.delete(deviceId);
|
|
22616
|
-
this.stateByDevice.delete(deviceId);
|
|
22617
|
-
}
|
|
22618
|
-
async loadRules(deviceId, stage) {
|
|
22619
|
-
let perDevice = this.cache.get(deviceId);
|
|
22620
|
-
if (!perDevice) {
|
|
22621
|
-
perDevice = /* @__PURE__ */ new Map();
|
|
22622
|
-
this.cache.set(deviceId, perDevice);
|
|
22713
|
+
if (lifecycle.pollTimer) {
|
|
22714
|
+
clearTimeout(lifecycle.pollTimer);
|
|
22715
|
+
lifecycle.pollTimer = void 0;
|
|
22623
22716
|
}
|
|
22624
|
-
const
|
|
22625
|
-
if (
|
|
22626
|
-
|
|
22627
|
-
|
|
22628
|
-
|
|
22629
|
-
|
|
22630
|
-
|
|
22631
|
-
|
|
22632
|
-
|
|
22633
|
-
tags: { deviceId },
|
|
22634
|
-
meta: {
|
|
22635
|
-
stage,
|
|
22636
|
-
issues: parsed.error.issues
|
|
22637
|
-
}
|
|
22638
|
-
});
|
|
22639
|
-
}
|
|
22640
|
-
} catch (err) {
|
|
22641
|
-
this.ctx.logger.warn("zone-rules store read failed — using empty list", {
|
|
22642
|
-
tags: { deviceId },
|
|
22643
|
-
meta: {
|
|
22644
|
-
stage,
|
|
22645
|
-
error: err instanceof Error ? err.message : String(err)
|
|
22646
|
-
}
|
|
22717
|
+
const subId = lifecycle.activeSubscriptionId;
|
|
22718
|
+
if (subId) {
|
|
22719
|
+
lifecycle.activeSubscriptionId = null;
|
|
22720
|
+
options.api.streamBroker.unsubscribeAudioChunks.mutate({ subscriptionId: subId }).catch((err) => {
|
|
22721
|
+
options.logger.warn("audio-chunk poller: unsubscribeAudioChunks failed", { meta: {
|
|
22722
|
+
brokerId: options.brokerId,
|
|
22723
|
+
subscriptionId: subId,
|
|
22724
|
+
error: errMsg(err)
|
|
22725
|
+
} });
|
|
22647
22726
|
});
|
|
22648
22727
|
}
|
|
22649
|
-
|
|
22650
|
-
|
|
22651
|
-
|
|
22652
|
-
|
|
22653
|
-
|
|
22654
|
-
|
|
22655
|
-
|
|
22656
|
-
|
|
22657
|
-
|
|
22658
|
-
|
|
22659
|
-
|
|
22660
|
-
|
|
22661
|
-
|
|
22662
|
-
|
|
22663
|
-
|
|
22664
|
-
const otherRules = perDevice.get(otherStage) ?? await this.loadRules(deviceId, otherStage);
|
|
22665
|
-
const sliceValue = stage === "motion" ? {
|
|
22666
|
-
motion: rules,
|
|
22667
|
-
detection: otherRules
|
|
22668
|
-
} : {
|
|
22669
|
-
motion: otherRules,
|
|
22670
|
-
detection: rules
|
|
22671
|
-
};
|
|
22728
|
+
};
|
|
22729
|
+
subscribeWithRetry(options, lifecycle);
|
|
22730
|
+
return teardown;
|
|
22731
|
+
}
|
|
22732
|
+
/**
|
|
22733
|
+
* Run the subscribe → poll handshake with exponential backoff on subscribe
|
|
22734
|
+
* failures. Resolves once the subscription is acquired (and the poll loop has
|
|
22735
|
+
* been started) or once `lifecycle.stopped` flips, whichever comes first.
|
|
22736
|
+
*/
|
|
22737
|
+
async function subscribeWithRetry(options, lifecycle) {
|
|
22738
|
+
const { api, brokerId, tag, logger } = options;
|
|
22739
|
+
let backoffMs = INITIAL_SUBSCRIBE_RETRY_BACKOFF_MS;
|
|
22740
|
+
let attempt = 0;
|
|
22741
|
+
while (!lifecycle.stopped) {
|
|
22742
|
+
attempt += 1;
|
|
22672
22743
|
try {
|
|
22673
|
-
|
|
22674
|
-
|
|
22675
|
-
|
|
22744
|
+
const result = await api.streamBroker.subscribeAudioChunks.mutate({
|
|
22745
|
+
brokerId,
|
|
22746
|
+
tag
|
|
22676
22747
|
});
|
|
22748
|
+
if (lifecycle.stopped) {
|
|
22749
|
+
await api.streamBroker.unsubscribeAudioChunks.mutate({ subscriptionId: result.subscriptionId }).catch((err) => {
|
|
22750
|
+
logger.warn("audio-chunk poller: late unsubscribe failed", { meta: {
|
|
22751
|
+
brokerId,
|
|
22752
|
+
subscriptionId: result.subscriptionId,
|
|
22753
|
+
error: errMsg(err)
|
|
22754
|
+
} });
|
|
22755
|
+
});
|
|
22756
|
+
return;
|
|
22757
|
+
}
|
|
22758
|
+
if (attempt > 1) logger.info("audio-chunk poller: subscribeAudioChunks recovered", { meta: {
|
|
22759
|
+
brokerId,
|
|
22760
|
+
tag,
|
|
22761
|
+
attempt
|
|
22762
|
+
} });
|
|
22763
|
+
lifecycle.activeSubscriptionId = result.subscriptionId;
|
|
22764
|
+
startPolling(options, lifecycle);
|
|
22765
|
+
return;
|
|
22677
22766
|
} catch (err) {
|
|
22678
|
-
|
|
22679
|
-
|
|
22680
|
-
|
|
22681
|
-
|
|
22682
|
-
|
|
22683
|
-
|
|
22684
|
-
});
|
|
22767
|
+
if (lifecycle.stopped) return;
|
|
22768
|
+
if (attempt === 1) logger.warn("audio-chunk poller: subscribeAudioChunks failed, retrying", { meta: {
|
|
22769
|
+
brokerId,
|
|
22770
|
+
tag,
|
|
22771
|
+
error: errMsg(err),
|
|
22772
|
+
nextRetryInMs: backoffMs
|
|
22773
|
+
} });
|
|
22774
|
+
else logger.debug("audio-chunk poller: subscribeAudioChunks still failing", { meta: {
|
|
22775
|
+
brokerId,
|
|
22776
|
+
tag,
|
|
22777
|
+
attempt,
|
|
22778
|
+
error: errMsg(err),
|
|
22779
|
+
nextRetryInMs: backoffMs
|
|
22780
|
+
} });
|
|
22781
|
+
await sleep(backoffMs, lifecycle);
|
|
22782
|
+
backoffMs = Math.min(MAX_SUBSCRIBE_RETRY_BACKOFF_MS, backoffMs * 2);
|
|
22685
22783
|
}
|
|
22686
|
-
this.ctx.onRulesChanged?.(deviceId, stage, rules);
|
|
22687
22784
|
}
|
|
22688
|
-
};
|
|
22689
|
-
//#endregion
|
|
22690
|
-
//#region src/orchestrator-store-schemas.ts
|
|
22691
|
-
/**
|
|
22692
|
-
* `orchestrator-store-schemas.ts` — whole-blob Zod schemas for the
|
|
22693
|
-
* orchestrator's addon-store keys that persist an ENTIRE collection
|
|
22694
|
-
* under a single key (`nodeBindings`, `templates`, `agentSettings`,
|
|
22695
|
-
* `cameraSettings`).
|
|
22696
|
-
*
|
|
22697
|
-
* These back the durable-state primitive (`this.state(KEY, Schema, {})`)
|
|
22698
|
-
* so a hand-written serializer can never silently drop a field on save:
|
|
22699
|
-
* the whole validated value round-trips on every read and write.
|
|
22700
|
-
*
|
|
22701
|
-
* Each schema mirrors the SAME shape the orchestrator already persisted
|
|
22702
|
-
* (the `pipeline-orchestrator.cap.ts` storage contract). Every field that
|
|
22703
|
-
* is only conditionally written is `.optional()`, so an existing blob
|
|
22704
|
-
* that predates a newer field still loads — durable-state `get()` only
|
|
22705
|
-
* falls back to the empty map on a whole-blob parse failure, so the
|
|
22706
|
-
* schema is kept faithful to the on-disk shape rather than overly strict.
|
|
22707
|
-
*/
|
|
22708
|
-
var EngineChoiceSchema = object({
|
|
22709
|
-
runtime: _enum(["node", "python"]),
|
|
22710
|
-
backend: string(),
|
|
22711
|
-
format: string(),
|
|
22712
|
-
device: string().optional()
|
|
22713
|
-
});
|
|
22714
|
-
var NodeBindingsSchema = record(string(), record(string(), string()));
|
|
22715
|
-
var StoredPipelineConfigSchema = object({
|
|
22716
|
-
engine: EngineChoiceSchema,
|
|
22717
|
-
steps: array(PipelineStepInputSchema).readonly(),
|
|
22718
|
-
audio: object({
|
|
22719
|
-
engine: EngineChoiceSchema,
|
|
22720
|
-
modelId: string(),
|
|
22721
|
-
enabled: boolean(),
|
|
22722
|
-
settings: record(string(), unknown()).readonly().optional()
|
|
22723
|
-
}).nullable().optional()
|
|
22724
|
-
});
|
|
22725
|
-
var StoredPipelineTemplateSchema = object({
|
|
22726
|
-
id: string(),
|
|
22727
|
-
name: string(),
|
|
22728
|
-
description: string().optional(),
|
|
22729
|
-
config: StoredPipelineConfigSchema,
|
|
22730
|
-
createdAt: string(),
|
|
22731
|
-
updatedAt: string()
|
|
22732
|
-
});
|
|
22733
|
-
var TemplatesSchema = record(string(), StoredPipelineTemplateSchema);
|
|
22734
|
-
var StoredAgentAddonConfigSchema = object({
|
|
22735
|
-
enabled: boolean(),
|
|
22736
|
-
modelId: string(),
|
|
22737
|
-
settings: record(string(), unknown()).readonly()
|
|
22738
|
-
});
|
|
22739
|
-
var StoredAgentPipelineSettingsSchema = object({
|
|
22740
|
-
addonDefaults: record(string(), StoredAgentAddonConfigSchema).readonly(),
|
|
22741
|
-
maxCameras: number().int().nonnegative().nullable().default(null)
|
|
22742
|
-
});
|
|
22743
|
-
var AgentSettingsMapSchema = record(string(), StoredAgentPipelineSettingsSchema);
|
|
22744
|
-
var StoredCameraStepOverridePatchSchema = object({
|
|
22745
|
-
enabled: boolean().optional(),
|
|
22746
|
-
modelId: string().optional(),
|
|
22747
|
-
settings: record(string(), unknown()).readonly().optional()
|
|
22748
|
-
});
|
|
22749
|
-
var StoredCameraPipelineForAgentSchema = object({
|
|
22750
|
-
steps: array(PipelineStepInputSchema).readonly(),
|
|
22751
|
-
audio: object({
|
|
22752
|
-
modelId: string(),
|
|
22753
|
-
enabled: boolean()
|
|
22754
|
-
}).nullable()
|
|
22755
|
-
});
|
|
22756
|
-
var StoredCameraPipelineSettingsSchema = object({
|
|
22757
|
-
pinnedAgentNodeId: string().optional(),
|
|
22758
|
-
stepToggles: record(string(), boolean()).optional(),
|
|
22759
|
-
stepOverridesByAgent: record(string(), record(string(), StoredCameraStepOverridePatchSchema)).optional(),
|
|
22760
|
-
pipelineByAgent: record(string(), StoredCameraPipelineForAgentSchema).optional(),
|
|
22761
|
-
/**
|
|
22762
|
-
* Legacy "nuke inference" flag. Superseded by the detection-pipeline
|
|
22763
|
-
* wrapper binding, but the one-shot boot migration
|
|
22764
|
-
* (`migrateLegacyFlagsToBindings`) still reads it off the persisted
|
|
22765
|
-
* blob to flip the binding off. Kept here so the durable round-trip
|
|
22766
|
-
* does NOT strip it before the migration runs.
|
|
22767
|
-
*/
|
|
22768
|
-
disableInference: boolean().optional()
|
|
22769
|
-
});
|
|
22770
|
-
var CameraSettingsMapSchema = record(string(), StoredCameraPipelineSettingsSchema);
|
|
22771
|
-
//#endregion
|
|
22772
|
-
//#region src/load-balancer.ts
|
|
22773
|
-
/**
|
|
22774
|
-
* Compute the L2 capacity score for a runner node. Lower is better.
|
|
22775
|
-
* The score is a weighted sum of the runner's active workload so the balancer
|
|
22776
|
-
* prefers agents that are serving fewer cameras OR draining queues quickly.
|
|
22777
|
-
*
|
|
22778
|
-
* Rationale:
|
|
22779
|
-
* - `attachedCameras * avgInferenceFps` approximates the total inference rate
|
|
22780
|
-
* the agent is currently sustaining (not just how many cameras are assigned).
|
|
22781
|
-
* - `queueDepthTotal` penalises agents that are falling behind the frame feed.
|
|
22782
|
-
*/
|
|
22783
|
-
function computeCapacityScore(load) {
|
|
22784
|
-
return load.attachedCameras * Math.max(load.avgInferenceFps, 0) + Math.max(load.queueDepthTotal, 0);
|
|
22785
|
-
}
|
|
22786
|
-
/**
|
|
22787
|
-
* Returns true when the node has remaining capacity.
|
|
22788
|
-
* A node is eligible iff `cap` is unlimited (null/absent/<=0) OR
|
|
22789
|
-
* its `attachedCameras` count is strictly less than the cap.
|
|
22790
|
-
* Pins count toward the cap via `attachedCameras`.
|
|
22791
|
-
*/
|
|
22792
|
-
function isEligible(node, caps) {
|
|
22793
|
-
const cap = caps?.[node.nodeId];
|
|
22794
|
-
if (cap === null || cap === void 0 || cap <= 0) return true;
|
|
22795
|
-
return node.attachedCameras < cap;
|
|
22796
22785
|
}
|
|
22797
22786
|
/**
|
|
22798
|
-
*
|
|
22799
|
-
*
|
|
22800
|
-
*
|
|
22801
|
-
*
|
|
22802
|
-
* or over cap, return `{kind:'pending'}` — a pinned camera is never silently
|
|
22803
|
-
* over-assigned.
|
|
22804
|
-
*
|
|
22805
|
-
* L2 (capacity): filter to eligible nodes and pick the lowest capacity score.
|
|
22806
|
-
* If all nodes are at/over cap, return `{kind:'pending'}`.
|
|
22807
|
-
*
|
|
22808
|
-
* Returns `null` when no runners are online. The orchestrator decides how to
|
|
22809
|
-
* react — typically by logging and deferring the assignment until a runner
|
|
22810
|
-
* comes online.
|
|
22787
|
+
* Drive the steady-state poll loop. Mid-stream `pullAudioChunks` failures
|
|
22788
|
+
* trigger a fresh `subscribeAudioChunks` via the recovery branch — covers
|
|
22789
|
+
* the broker child restart case where our `subscriptionId` is silently
|
|
22790
|
+
* disowned.
|
|
22811
22791
|
*/
|
|
22812
|
-
function
|
|
22813
|
-
const
|
|
22814
|
-
|
|
22815
|
-
const
|
|
22816
|
-
|
|
22817
|
-
|
|
22818
|
-
|
|
22819
|
-
|
|
22820
|
-
|
|
22821
|
-
|
|
22822
|
-
|
|
22823
|
-
|
|
22824
|
-
|
|
22825
|
-
|
|
22826
|
-
|
|
22827
|
-
|
|
22828
|
-
|
|
22792
|
+
function startPolling(options, lifecycle) {
|
|
22793
|
+
const { api, brokerId, tag, onChunk, logger } = options;
|
|
22794
|
+
let consecutiveFailures = 0;
|
|
22795
|
+
const resubscribe = async () => {
|
|
22796
|
+
try {
|
|
22797
|
+
const result = await api.streamBroker.subscribeAudioChunks.mutate({
|
|
22798
|
+
brokerId,
|
|
22799
|
+
tag
|
|
22800
|
+
});
|
|
22801
|
+
lifecycle.activeSubscriptionId = result.subscriptionId;
|
|
22802
|
+
logger.info("audio-chunk poller: re-subscribed after broker outage", { meta: {
|
|
22803
|
+
brokerId,
|
|
22804
|
+
tag,
|
|
22805
|
+
subscriptionId: result.subscriptionId,
|
|
22806
|
+
afterFailures: consecutiveFailures
|
|
22807
|
+
} });
|
|
22808
|
+
return true;
|
|
22809
|
+
} catch {
|
|
22810
|
+
return false;
|
|
22829
22811
|
}
|
|
22830
|
-
}
|
|
22831
|
-
if (eligible.length === 0) return {
|
|
22832
|
-
kind: "pending",
|
|
22833
|
-
reason: "over-cap"
|
|
22834
22812
|
};
|
|
22835
|
-
const
|
|
22836
|
-
|
|
22837
|
-
|
|
22838
|
-
|
|
22839
|
-
|
|
22840
|
-
|
|
22841
|
-
|
|
22842
|
-
|
|
22843
|
-
|
|
22813
|
+
const tick = async () => {
|
|
22814
|
+
if (lifecycle.stopped) return;
|
|
22815
|
+
const subId = lifecycle.activeSubscriptionId;
|
|
22816
|
+
if (!subId) return;
|
|
22817
|
+
try {
|
|
22818
|
+
const chunks = await api.streamBroker.pullAudioChunks.query({
|
|
22819
|
+
subscriptionId: subId,
|
|
22820
|
+
maxCount: PULL_MAX_COUNT
|
|
22821
|
+
});
|
|
22822
|
+
if (consecutiveFailures > 0) logger.info("audio-chunk poller: stream recovered", { meta: {
|
|
22823
|
+
brokerId,
|
|
22824
|
+
subscriptionId: subId
|
|
22825
|
+
} });
|
|
22826
|
+
consecutiveFailures = 0;
|
|
22827
|
+
for (const chunk of chunks) {
|
|
22828
|
+
if (lifecycle.stopped) break;
|
|
22829
|
+
await onChunk(chunk);
|
|
22830
|
+
}
|
|
22831
|
+
} catch (err) {
|
|
22832
|
+
consecutiveFailures += 1;
|
|
22833
|
+
if (consecutiveFailures === 1) logger.warn("audio-chunk poller: pullAudioChunks failed — attempting recovery", { meta: {
|
|
22834
|
+
brokerId,
|
|
22835
|
+
subscriptionId: subId,
|
|
22836
|
+
error: errMsg(err)
|
|
22837
|
+
} });
|
|
22838
|
+
if (!lifecycle.stopped && consecutiveFailures >= RESUBSCRIBE_AFTER_FAILURES && (consecutiveFailures - RESUBSCRIBE_AFTER_FAILURES) % RESUBSCRIBE_THROTTLE_TICKS === 0) await resubscribe();
|
|
22839
|
+
}
|
|
22840
|
+
if (!lifecycle.stopped) lifecycle.pollTimer = setTimeout(() => void tick(), POLL_INTERVAL_MS);
|
|
22844
22841
|
};
|
|
22842
|
+
tick();
|
|
22845
22843
|
}
|
|
22846
22844
|
/**
|
|
22847
|
-
*
|
|
22848
|
-
*
|
|
22849
|
-
*
|
|
22850
|
-
*
|
|
22851
|
-
*
|
|
22852
|
-
* disabled). A pin to an ENABLED node is honored; anything else falls through
|
|
22853
|
-
* to the auto-balance path (which filters by `enabledDecoderNodes`).
|
|
22854
|
-
*/
|
|
22855
|
-
function isDecoderPinHonored(pinnedNodeId, enabledDecoderNodes) {
|
|
22856
|
-
return enabledDecoderNodes.includes(pinnedNodeId);
|
|
22857
|
-
}
|
|
22858
|
-
/**
|
|
22859
|
-
* Choose decoder node. Priority: manual pin → co-located with pipeline → capacity.
|
|
22845
|
+
* Cancellable sleep — wakes early when `lifecycle.stopped` flips. We
|
|
22846
|
+
* keep a local wrapper around the shared {@link sleep} helper because
|
|
22847
|
+
* the lifecycle tracks the active retry timer for `teardown()` to
|
|
22848
|
+
* clear; pure `sleep()` would leak the timer if teardown fired while
|
|
22849
|
+
* we were waiting.
|
|
22860
22850
|
*/
|
|
22861
|
-
function
|
|
22862
|
-
|
|
22863
|
-
|
|
22864
|
-
|
|
22865
|
-
|
|
22866
|
-
|
|
22867
|
-
|
|
22868
|
-
|
|
22869
|
-
|
|
22870
|
-
};
|
|
22871
|
-
}
|
|
22872
|
-
const colocated = decoderNodes.find((n) => n.nodeId === pipelineNodeId);
|
|
22873
|
-
if (colocated) return {
|
|
22874
|
-
decoderNodeId: colocated.nodeId,
|
|
22875
|
-
reason: "co-located",
|
|
22876
|
-
score: computeCapacityScore(colocated)
|
|
22877
|
-
};
|
|
22878
|
-
const best = decoderNodes.map((node) => ({
|
|
22879
|
-
node,
|
|
22880
|
-
score: computeCapacityScore(node)
|
|
22881
|
-
})).toSorted((a, b) => a.score - b.score)[0];
|
|
22882
|
-
return {
|
|
22883
|
-
decoderNodeId: best.node.nodeId,
|
|
22884
|
-
reason: "capacity",
|
|
22885
|
-
score: best.score
|
|
22886
|
-
};
|
|
22851
|
+
function sleep(ms, lifecycle) {
|
|
22852
|
+
return new Promise((resolve) => {
|
|
22853
|
+
if (lifecycle.stopped) {
|
|
22854
|
+
resolve();
|
|
22855
|
+
return;
|
|
22856
|
+
}
|
|
22857
|
+
lifecycle.retryTimer = setTimeout(() => {
|
|
22858
|
+
lifecycle.retryTimer = void 0;
|
|
22859
|
+
resolve();
|
|
22860
|
+
}, ms);
|
|
22861
|
+
});
|
|
22887
22862
|
}
|
|
22888
22863
|
//#endregion
|
|
22889
22864
|
//#region src/audio-load-balancer.ts
|
|
@@ -22902,259 +22877,393 @@ function balanceAudio(input) {
|
|
|
22902
22877
|
};
|
|
22903
22878
|
}
|
|
22904
22879
|
//#endregion
|
|
22905
|
-
//#region src/
|
|
22880
|
+
//#region src/camera-status/compose-camera-status.ts
|
|
22881
|
+
function mapAssignment(input) {
|
|
22882
|
+
return {
|
|
22883
|
+
detectionNodeId: input.detectionNodeId,
|
|
22884
|
+
decoderNodeId: input.decoderNodeId,
|
|
22885
|
+
audioNodeId: input.audioNodeId,
|
|
22886
|
+
pinned: {
|
|
22887
|
+
detection: input.pinned.detection,
|
|
22888
|
+
decoder: input.pinned.decoder,
|
|
22889
|
+
audio: input.pinned.audio
|
|
22890
|
+
},
|
|
22891
|
+
reasons: {
|
|
22892
|
+
detection: input.reasons.detection,
|
|
22893
|
+
decoder: input.reasons.decoder,
|
|
22894
|
+
audio: input.reasons.audio
|
|
22895
|
+
}
|
|
22896
|
+
};
|
|
22897
|
+
}
|
|
22898
|
+
function mapSource(sourceResult) {
|
|
22899
|
+
if (sourceResult === null) return { streams: [] };
|
|
22900
|
+
return { streams: sourceResult.streams.map((s) => ({
|
|
22901
|
+
camStreamId: s.camStreamId,
|
|
22902
|
+
codec: s.codec,
|
|
22903
|
+
width: s.width,
|
|
22904
|
+
height: s.height,
|
|
22905
|
+
fps: s.fps,
|
|
22906
|
+
kind: s.kind
|
|
22907
|
+
})) };
|
|
22908
|
+
}
|
|
22909
|
+
function mapBroker(brokerResult) {
|
|
22910
|
+
if (brokerResult === null) return null;
|
|
22911
|
+
return {
|
|
22912
|
+
profiles: brokerResult.profiles.map((p) => ({
|
|
22913
|
+
profile: p.profile,
|
|
22914
|
+
status: p.status,
|
|
22915
|
+
codec: p.codec,
|
|
22916
|
+
width: p.width,
|
|
22917
|
+
height: p.height,
|
|
22918
|
+
subscribers: p.subscribers,
|
|
22919
|
+
inFps: p.inFps,
|
|
22920
|
+
outFps: p.outFps
|
|
22921
|
+
})),
|
|
22922
|
+
webrtcSessions: brokerResult.webrtcSessions,
|
|
22923
|
+
rtspRestream: brokerResult.rtspRestream
|
|
22924
|
+
};
|
|
22925
|
+
}
|
|
22926
|
+
function mapDecoderShm(shm) {
|
|
22927
|
+
return {
|
|
22928
|
+
framesWritten: shm.framesWritten,
|
|
22929
|
+
getFrameHits: shm.getFrameHits,
|
|
22930
|
+
getFrameMisses: shm.getFrameMisses,
|
|
22931
|
+
budgetMb: shm.budgetMb
|
|
22932
|
+
};
|
|
22933
|
+
}
|
|
22934
|
+
function mapDecoder(decoderResult) {
|
|
22935
|
+
if (decoderResult === null) return null;
|
|
22936
|
+
return {
|
|
22937
|
+
nodeId: decoderResult.nodeId,
|
|
22938
|
+
formats: [...decoderResult.formats],
|
|
22939
|
+
sessionCount: decoderResult.sessionCount,
|
|
22940
|
+
shm: mapDecoderShm(decoderResult.shm)
|
|
22941
|
+
};
|
|
22942
|
+
}
|
|
22943
|
+
function mapMotion(motionResult) {
|
|
22944
|
+
if (motionResult === null) return null;
|
|
22945
|
+
return {
|
|
22946
|
+
enabled: motionResult.enabled,
|
|
22947
|
+
fps: motionResult.fps
|
|
22948
|
+
};
|
|
22949
|
+
}
|
|
22950
|
+
function mapProvisioning(p) {
|
|
22951
|
+
if (p.error !== void 0) return {
|
|
22952
|
+
state: p.state,
|
|
22953
|
+
error: p.error
|
|
22954
|
+
};
|
|
22955
|
+
return { state: p.state };
|
|
22956
|
+
}
|
|
22957
|
+
function mapDetection(detectionResult) {
|
|
22958
|
+
if (detectionResult === null) return null;
|
|
22959
|
+
const phase = detectionResult.phase;
|
|
22960
|
+
return {
|
|
22961
|
+
nodeId: detectionResult.nodeId,
|
|
22962
|
+
engine: {
|
|
22963
|
+
backend: detectionResult.engine.backend,
|
|
22964
|
+
device: detectionResult.engine.device
|
|
22965
|
+
},
|
|
22966
|
+
phase,
|
|
22967
|
+
configuredFps: detectionResult.configuredFps,
|
|
22968
|
+
actualFps: detectionResult.actualFps,
|
|
22969
|
+
queueDepth: detectionResult.queueDepth,
|
|
22970
|
+
avgInferenceMs: detectionResult.avgInferenceMs,
|
|
22971
|
+
provisioning: mapProvisioning(detectionResult.provisioning)
|
|
22972
|
+
};
|
|
22973
|
+
}
|
|
22974
|
+
function mapAudio(audioResult) {
|
|
22975
|
+
if (audioResult === null) return null;
|
|
22976
|
+
return {
|
|
22977
|
+
nodeId: audioResult.nodeId,
|
|
22978
|
+
enabled: audioResult.enabled
|
|
22979
|
+
};
|
|
22980
|
+
}
|
|
22981
|
+
function mapRecording(recordingResult) {
|
|
22982
|
+
if (recordingResult === null) return null;
|
|
22983
|
+
return {
|
|
22984
|
+
mode: recordingResult.mode,
|
|
22985
|
+
active: recordingResult.active,
|
|
22986
|
+
storageBytes: recordingResult.storageBytes
|
|
22987
|
+
};
|
|
22988
|
+
}
|
|
22906
22989
|
/**
|
|
22907
|
-
*
|
|
22908
|
-
* plane (Phase 5 / D9).
|
|
22909
|
-
*
|
|
22910
|
-
* Replaces the live-object `IStreamBroker.onDecodedAudioChunk(cb)` callback
|
|
22911
|
-
* path. A live callback cannot cross a process boundary; once the `pipeline`
|
|
22912
|
-
* group is dissolved (Task 8) the orchestrator runs in a different process
|
|
22913
|
-
* from the broker, so audio delivery must go over tRPC.
|
|
22914
|
-
*
|
|
22915
|
-
* The consumer:
|
|
22990
|
+
* Pure function that composes a `CameraStatus` from per-stage fetch results.
|
|
22916
22991
|
*
|
|
22917
|
-
*
|
|
22918
|
-
*
|
|
22919
|
-
*
|
|
22920
|
-
*
|
|
22921
|
-
*
|
|
22922
|
-
|
|
22923
|
-
|
|
22992
|
+
* - `assignment` is always built from orchestrator-local data (never null).
|
|
22993
|
+
* - `source` always present: defaults to `{ streams: [] }` when sourceResult is null.
|
|
22994
|
+
* - Every other block is null when its stage result is null (graceful degradation).
|
|
22995
|
+
* - `fetchedAt` is stamped exactly as provided — never calls `Date.now()`.
|
|
22996
|
+
* - No mutation of the input.
|
|
22997
|
+
*/
|
|
22998
|
+
function composeCameraStatus(input) {
|
|
22999
|
+
return {
|
|
23000
|
+
deviceId: input.deviceId,
|
|
23001
|
+
assignment: mapAssignment(input),
|
|
23002
|
+
source: mapSource(input.sourceResult),
|
|
23003
|
+
broker: mapBroker(input.brokerResult),
|
|
23004
|
+
decoder: mapDecoder(input.decoderResult),
|
|
23005
|
+
motion: mapMotion(input.motionResult),
|
|
23006
|
+
detection: mapDetection(input.detectionResult),
|
|
23007
|
+
audio: mapAudio(input.audioResult),
|
|
23008
|
+
recording: mapRecording(input.recordingResult),
|
|
23009
|
+
fetchedAt: input.fetchedAt
|
|
23010
|
+
};
|
|
23011
|
+
}
|
|
23012
|
+
//#endregion
|
|
23013
|
+
//#region src/dispatch-reconcile.ts
|
|
23014
|
+
/**
|
|
23015
|
+
* Derives the set of deviceIds that currently have at least one broker
|
|
23016
|
+
* profile slot that is assigned (status !== 'unassigned') AND has a
|
|
23017
|
+
* non-null sourceCamStreamId.
|
|
22924
23018
|
*
|
|
22925
|
-
*
|
|
22926
|
-
*
|
|
22927
|
-
*
|
|
22928
|
-
|
|
22929
|
-
|
|
23019
|
+
* This is the "desired" fleet — cameras the orchestrator should have
|
|
23020
|
+
* dispatched. Used by `reconcileDispatch` to compute the gap against
|
|
23021
|
+
* `cameraConfigs`.
|
|
23022
|
+
*/
|
|
23023
|
+
function desiredDeviceIdsFromSlots(slots) {
|
|
23024
|
+
const result = /* @__PURE__ */ new Set();
|
|
23025
|
+
for (const slot of slots) if (slot.status !== "unassigned" && slot.sourceCamStreamId !== null) result.add(slot.deviceId);
|
|
23026
|
+
return result;
|
|
23027
|
+
}
|
|
23028
|
+
/**
|
|
23029
|
+
* Returns the deviceIds that are present in `desired` but absent from
|
|
23030
|
+
* `known`. These are the cameras the orchestrator has not yet dispatched
|
|
23031
|
+
* and needs to process via `handleDeviceRegistered`.
|
|
22930
23032
|
*
|
|
22931
|
-
*
|
|
22932
|
-
*
|
|
22933
|
-
* their cameraStreams asynchronously after their probe completes).
|
|
22934
|
-
* `subscribeAudioChunks` retries with exponential backoff (capped at
|
|
22935
|
-
* `MAX_SUBSCRIBE_RETRY_BACKOFF_MS`) until it succeeds or the returned
|
|
22936
|
-
* teardown closure is invoked. Mirrors the `FrameHandlePoller` recovery
|
|
22937
|
-
* shape so video and audio plumbing self-heal identically.
|
|
23033
|
+
* Additive only — cameras present in `known` are never included, even
|
|
23034
|
+
* if they fall out of `desired`, to avoid fighting the live event path.
|
|
22938
23035
|
*/
|
|
22939
|
-
|
|
22940
|
-
|
|
22941
|
-
|
|
22942
|
-
|
|
23036
|
+
function computeDispatchGap(desired, known) {
|
|
23037
|
+
return [...desired].filter((id) => !known.has(id));
|
|
23038
|
+
}
|
|
23039
|
+
//#endregion
|
|
23040
|
+
//#region src/load-balancer.ts
|
|
22943
23041
|
/**
|
|
22944
|
-
*
|
|
22945
|
-
*
|
|
22946
|
-
*
|
|
22947
|
-
*
|
|
23042
|
+
* Compute the L2 capacity score for a runner node. Lower is better.
|
|
23043
|
+
* The score is a weighted sum of the runner's active workload so the balancer
|
|
23044
|
+
* prefers agents that are serving fewer cameras OR draining queues quickly.
|
|
23045
|
+
*
|
|
23046
|
+
* Rationale:
|
|
23047
|
+
* - `attachedCameras * avgInferenceFps` approximates the total inference rate
|
|
23048
|
+
* the agent is currently sustaining (not just how many cameras are assigned).
|
|
23049
|
+
* - `queueDepthTotal` penalises agents that are falling behind the frame feed.
|
|
22948
23050
|
*/
|
|
22949
|
-
|
|
22950
|
-
|
|
22951
|
-
|
|
22952
|
-
/** First subscribe-retry delay, doubled on every subsequent failure. */
|
|
22953
|
-
var INITIAL_SUBSCRIBE_RETRY_BACKOFF_MS = 250;
|
|
23051
|
+
function computeCapacityScore(load) {
|
|
23052
|
+
return load.attachedCameras * Math.max(load.avgInferenceFps, 0) + Math.max(load.queueDepthTotal, 0);
|
|
23053
|
+
}
|
|
22954
23054
|
/**
|
|
22955
|
-
*
|
|
22956
|
-
*
|
|
22957
|
-
*
|
|
23055
|
+
* Returns true when the node has remaining capacity.
|
|
23056
|
+
* A node is eligible iff `cap` is unlimited (null/absent/<=0) OR
|
|
23057
|
+
* its `attachedCameras` count is strictly less than the cap.
|
|
23058
|
+
* Pins count toward the cap via `attachedCameras`.
|
|
22958
23059
|
*/
|
|
22959
|
-
|
|
23060
|
+
function isEligible(node, caps) {
|
|
23061
|
+
const cap = caps?.[node.nodeId];
|
|
23062
|
+
if (cap === null || cap === void 0 || cap <= 0) return true;
|
|
23063
|
+
return node.attachedCameras < cap;
|
|
23064
|
+
}
|
|
22960
23065
|
/**
|
|
22961
|
-
*
|
|
23066
|
+
* Run the two-level camera balancer.
|
|
22962
23067
|
*
|
|
22963
|
-
*
|
|
22964
|
-
*
|
|
22965
|
-
*
|
|
22966
|
-
*
|
|
23068
|
+
* Frame-source constraint: when `eligibleNodes` is set, only nodes in that set
|
|
23069
|
+
* can obtain this camera's decoded frames. Such a node is a prerequisite for
|
|
23070
|
+
* BOTH L1 and L2 — a node outside `eligibleNodes` is never assignable, and a
|
|
23071
|
+
* pin to an online-but-ineligible node returns `{kind:'pending',
|
|
23072
|
+
* reason:'no-frame-source'}` (mirrors the over-cap-pin behaviour: a pinned
|
|
23073
|
+
* camera is never silently placed on a different node).
|
|
23074
|
+
*
|
|
23075
|
+
* L1 (manual affinity): if `preferredAgent` names an online + frame-sourceable
|
|
23076
|
+
* node AND that node is under its `maxCameras` cap, return it. If the node is
|
|
23077
|
+
* online but at/over cap, return `{kind:'pending', reason:'over-cap'}`; if it
|
|
23078
|
+
* is online but not frame-sourceable, `{kind:'pending', reason:'no-frame-source'}`
|
|
23079
|
+
* — a pinned camera is never silently over-assigned or re-homed.
|
|
23080
|
+
*
|
|
23081
|
+
* L2 (capacity): among the frame-sourceable nodes, filter to those under cap
|
|
23082
|
+
* and pick the lowest capacity score. If no frame-sourceable node exists (but
|
|
23083
|
+
* online nodes do), return `no-frame-source`; if they exist but are all at/over
|
|
23084
|
+
* cap, return `over-cap`.
|
|
23085
|
+
*
|
|
23086
|
+
* Returns `null` when no runners are online. The orchestrator decides how to
|
|
23087
|
+
* react — typically by logging and deferring the assignment until a runner
|
|
23088
|
+
* comes online.
|
|
22967
23089
|
*/
|
|
22968
|
-
function
|
|
22969
|
-
const
|
|
22970
|
-
|
|
22971
|
-
|
|
22972
|
-
|
|
22973
|
-
|
|
22974
|
-
|
|
22975
|
-
|
|
22976
|
-
|
|
22977
|
-
|
|
22978
|
-
|
|
22979
|
-
|
|
22980
|
-
|
|
22981
|
-
|
|
22982
|
-
|
|
22983
|
-
|
|
22984
|
-
|
|
22985
|
-
|
|
22986
|
-
|
|
22987
|
-
|
|
22988
|
-
|
|
22989
|
-
|
|
22990
|
-
options.logger.warn("audio-chunk poller: unsubscribeAudioChunks failed", { meta: {
|
|
22991
|
-
brokerId: options.brokerId,
|
|
22992
|
-
subscriptionId: subId,
|
|
22993
|
-
error: errMsg(err)
|
|
22994
|
-
} });
|
|
22995
|
-
});
|
|
23090
|
+
function balance(input) {
|
|
23091
|
+
const online = input.nodes.filter((n) => n.nodeId.length > 0);
|
|
23092
|
+
if (online.length === 0) return null;
|
|
23093
|
+
const sourceable = input.eligibleNodes ? online.filter((n) => input.eligibleNodes.includes(n.nodeId)) : online;
|
|
23094
|
+
const eligible = sourceable.filter((n) => isEligible(n, input.nodeCaps));
|
|
23095
|
+
if (input.preferredAgent) {
|
|
23096
|
+
const pinnedOnline = online.find((n) => n.nodeId === input.preferredAgent);
|
|
23097
|
+
if (pinnedOnline) {
|
|
23098
|
+
if (!sourceable.some((n) => n.nodeId === pinnedOnline.nodeId)) return {
|
|
23099
|
+
kind: "pending",
|
|
23100
|
+
reason: "no-frame-source"
|
|
23101
|
+
};
|
|
23102
|
+
if (eligible.some((n) => n.nodeId === pinnedOnline.nodeId)) return {
|
|
23103
|
+
kind: "assigned",
|
|
23104
|
+
agentNodeId: pinnedOnline.nodeId,
|
|
23105
|
+
reason: "manual",
|
|
23106
|
+
score: computeCapacityScore(pinnedOnline)
|
|
23107
|
+
};
|
|
23108
|
+
return {
|
|
23109
|
+
kind: "pending",
|
|
23110
|
+
reason: "over-cap"
|
|
23111
|
+
};
|
|
22996
23112
|
}
|
|
23113
|
+
}
|
|
23114
|
+
if (eligible.length === 0) return {
|
|
23115
|
+
kind: "pending",
|
|
23116
|
+
reason: sourceable.length === 0 ? "no-frame-source" : "over-cap"
|
|
23117
|
+
};
|
|
23118
|
+
const best = eligible.map((node) => ({
|
|
23119
|
+
node,
|
|
23120
|
+
score: computeCapacityScore(node)
|
|
23121
|
+
})).toSorted((a, b) => a.score - b.score)[0];
|
|
23122
|
+
return {
|
|
23123
|
+
kind: "assigned",
|
|
23124
|
+
agentNodeId: best.node.nodeId,
|
|
23125
|
+
reason: "capacity",
|
|
23126
|
+
score: best.score
|
|
22997
23127
|
};
|
|
22998
|
-
subscribeWithRetry(options, lifecycle);
|
|
22999
|
-
return teardown;
|
|
23000
23128
|
}
|
|
23001
23129
|
/**
|
|
23002
|
-
*
|
|
23003
|
-
*
|
|
23004
|
-
*
|
|
23130
|
+
* Decide whether a manual per-device decoder pin may be honored.
|
|
23131
|
+
*
|
|
23132
|
+
* A pin to a node OUTSIDE `enabledDecoderNodes` must NOT be honored blindly —
|
|
23133
|
+
* that is how video decode reaches a node that is not eligible to decode (e.g.
|
|
23134
|
+
* a node whose shm frame ring the broker cannot read, or one an operator
|
|
23135
|
+
* disabled). A pin to an ENABLED node is honored; anything else falls through
|
|
23136
|
+
* to the auto-balance path (which filters by `enabledDecoderNodes`).
|
|
23005
23137
|
*/
|
|
23006
|
-
|
|
23007
|
-
|
|
23008
|
-
let backoffMs = INITIAL_SUBSCRIBE_RETRY_BACKOFF_MS;
|
|
23009
|
-
let attempt = 0;
|
|
23010
|
-
while (!lifecycle.stopped) {
|
|
23011
|
-
attempt += 1;
|
|
23012
|
-
try {
|
|
23013
|
-
const result = await api.streamBroker.subscribeAudioChunks.mutate({
|
|
23014
|
-
brokerId,
|
|
23015
|
-
tag
|
|
23016
|
-
});
|
|
23017
|
-
if (lifecycle.stopped) {
|
|
23018
|
-
await api.streamBroker.unsubscribeAudioChunks.mutate({ subscriptionId: result.subscriptionId }).catch((err) => {
|
|
23019
|
-
logger.warn("audio-chunk poller: late unsubscribe failed", { meta: {
|
|
23020
|
-
brokerId,
|
|
23021
|
-
subscriptionId: result.subscriptionId,
|
|
23022
|
-
error: errMsg(err)
|
|
23023
|
-
} });
|
|
23024
|
-
});
|
|
23025
|
-
return;
|
|
23026
|
-
}
|
|
23027
|
-
if (attempt > 1) logger.info("audio-chunk poller: subscribeAudioChunks recovered", { meta: {
|
|
23028
|
-
brokerId,
|
|
23029
|
-
tag,
|
|
23030
|
-
attempt
|
|
23031
|
-
} });
|
|
23032
|
-
lifecycle.activeSubscriptionId = result.subscriptionId;
|
|
23033
|
-
startPolling(options, lifecycle);
|
|
23034
|
-
return;
|
|
23035
|
-
} catch (err) {
|
|
23036
|
-
if (lifecycle.stopped) return;
|
|
23037
|
-
if (attempt === 1) logger.warn("audio-chunk poller: subscribeAudioChunks failed, retrying", { meta: {
|
|
23038
|
-
brokerId,
|
|
23039
|
-
tag,
|
|
23040
|
-
error: errMsg(err),
|
|
23041
|
-
nextRetryInMs: backoffMs
|
|
23042
|
-
} });
|
|
23043
|
-
else logger.debug("audio-chunk poller: subscribeAudioChunks still failing", { meta: {
|
|
23044
|
-
brokerId,
|
|
23045
|
-
tag,
|
|
23046
|
-
attempt,
|
|
23047
|
-
error: errMsg(err),
|
|
23048
|
-
nextRetryInMs: backoffMs
|
|
23049
|
-
} });
|
|
23050
|
-
await sleep(backoffMs, lifecycle);
|
|
23051
|
-
backoffMs = Math.min(MAX_SUBSCRIBE_RETRY_BACKOFF_MS, backoffMs * 2);
|
|
23052
|
-
}
|
|
23053
|
-
}
|
|
23138
|
+
function isDecoderPinHonored(pinnedNodeId, enabledDecoderNodes) {
|
|
23139
|
+
return enabledDecoderNodes.includes(pinnedNodeId);
|
|
23054
23140
|
}
|
|
23055
23141
|
/**
|
|
23056
|
-
*
|
|
23057
|
-
* trigger a fresh `subscribeAudioChunks` via the recovery branch — covers
|
|
23058
|
-
* the broker child restart case where our `subscriptionId` is silently
|
|
23059
|
-
* disowned.
|
|
23142
|
+
* Choose decoder node. Priority: manual pin → co-located with pipeline → capacity.
|
|
23060
23143
|
*/
|
|
23061
|
-
function
|
|
23062
|
-
const {
|
|
23063
|
-
|
|
23064
|
-
|
|
23065
|
-
|
|
23066
|
-
|
|
23067
|
-
|
|
23068
|
-
|
|
23069
|
-
|
|
23070
|
-
|
|
23071
|
-
|
|
23072
|
-
|
|
23073
|
-
|
|
23074
|
-
|
|
23075
|
-
|
|
23076
|
-
|
|
23077
|
-
return true;
|
|
23078
|
-
} catch {
|
|
23079
|
-
return false;
|
|
23080
|
-
}
|
|
23144
|
+
function balanceDecoder(input) {
|
|
23145
|
+
const { decoderNodes, pipelineNodeId, preferredDecoderNode } = input;
|
|
23146
|
+
if (decoderNodes.length === 0) return null;
|
|
23147
|
+
if (preferredDecoderNode) {
|
|
23148
|
+
const match = decoderNodes.find((n) => n.nodeId === preferredDecoderNode);
|
|
23149
|
+
if (match) return {
|
|
23150
|
+
decoderNodeId: match.nodeId,
|
|
23151
|
+
reason: "manual",
|
|
23152
|
+
score: computeCapacityScore(match)
|
|
23153
|
+
};
|
|
23154
|
+
}
|
|
23155
|
+
const colocated = decoderNodes.find((n) => n.nodeId === pipelineNodeId);
|
|
23156
|
+
if (colocated) return {
|
|
23157
|
+
decoderNodeId: colocated.nodeId,
|
|
23158
|
+
reason: "co-located",
|
|
23159
|
+
score: computeCapacityScore(colocated)
|
|
23081
23160
|
};
|
|
23082
|
-
const
|
|
23083
|
-
|
|
23084
|
-
|
|
23085
|
-
|
|
23086
|
-
|
|
23087
|
-
|
|
23088
|
-
|
|
23089
|
-
|
|
23090
|
-
});
|
|
23091
|
-
if (consecutiveFailures > 0) logger.info("audio-chunk poller: stream recovered", { meta: {
|
|
23092
|
-
brokerId,
|
|
23093
|
-
subscriptionId: subId
|
|
23094
|
-
} });
|
|
23095
|
-
consecutiveFailures = 0;
|
|
23096
|
-
for (const chunk of chunks) {
|
|
23097
|
-
if (lifecycle.stopped) break;
|
|
23098
|
-
await onChunk(chunk);
|
|
23099
|
-
}
|
|
23100
|
-
} catch (err) {
|
|
23101
|
-
consecutiveFailures += 1;
|
|
23102
|
-
if (consecutiveFailures === 1) logger.warn("audio-chunk poller: pullAudioChunks failed — attempting recovery", { meta: {
|
|
23103
|
-
brokerId,
|
|
23104
|
-
subscriptionId: subId,
|
|
23105
|
-
error: errMsg(err)
|
|
23106
|
-
} });
|
|
23107
|
-
if (!lifecycle.stopped && consecutiveFailures >= RESUBSCRIBE_AFTER_FAILURES && (consecutiveFailures - RESUBSCRIBE_AFTER_FAILURES) % RESUBSCRIBE_THROTTLE_TICKS === 0) await resubscribe();
|
|
23108
|
-
}
|
|
23109
|
-
if (!lifecycle.stopped) lifecycle.pollTimer = setTimeout(() => void tick(), POLL_INTERVAL_MS);
|
|
23161
|
+
const best = decoderNodes.map((node) => ({
|
|
23162
|
+
node,
|
|
23163
|
+
score: computeCapacityScore(node)
|
|
23164
|
+
})).toSorted((a, b) => a.score - b.score)[0];
|
|
23165
|
+
return {
|
|
23166
|
+
decoderNodeId: best.node.nodeId,
|
|
23167
|
+
reason: "capacity",
|
|
23168
|
+
score: best.score
|
|
23110
23169
|
};
|
|
23111
|
-
tick();
|
|
23112
|
-
}
|
|
23113
|
-
/**
|
|
23114
|
-
* Cancellable sleep — wakes early when `lifecycle.stopped` flips. We
|
|
23115
|
-
* keep a local wrapper around the shared {@link sleep} helper because
|
|
23116
|
-
* the lifecycle tracks the active retry timer for `teardown()` to
|
|
23117
|
-
* clear; pure `sleep()` would leak the timer if teardown fired while
|
|
23118
|
-
* we were waiting.
|
|
23119
|
-
*/
|
|
23120
|
-
function sleep(ms, lifecycle) {
|
|
23121
|
-
return new Promise((resolve) => {
|
|
23122
|
-
if (lifecycle.stopped) {
|
|
23123
|
-
resolve();
|
|
23124
|
-
return;
|
|
23125
|
-
}
|
|
23126
|
-
lifecycle.retryTimer = setTimeout(() => {
|
|
23127
|
-
lifecycle.retryTimer = void 0;
|
|
23128
|
-
resolve();
|
|
23129
|
-
}, ms);
|
|
23130
|
-
});
|
|
23131
23170
|
}
|
|
23132
23171
|
//#endregion
|
|
23133
|
-
//#region src/
|
|
23172
|
+
//#region src/orchestrator-store-schemas.ts
|
|
23134
23173
|
/**
|
|
23135
|
-
*
|
|
23136
|
-
*
|
|
23137
|
-
*
|
|
23174
|
+
* `orchestrator-store-schemas.ts` — whole-blob Zod schemas for the
|
|
23175
|
+
* orchestrator's addon-store keys that persist an ENTIRE collection
|
|
23176
|
+
* under a single key (`nodeBindings`, `templates`, `agentSettings`,
|
|
23177
|
+
* `cameraSettings`).
|
|
23138
23178
|
*
|
|
23139
|
-
*
|
|
23140
|
-
*
|
|
23141
|
-
*
|
|
23179
|
+
* These back the durable-state primitive (`this.state(KEY, Schema, {})`)
|
|
23180
|
+
* so a hand-written serializer can never silently drop a field on save:
|
|
23181
|
+
* the whole validated value round-trips on every read and write.
|
|
23182
|
+
*
|
|
23183
|
+
* Each schema mirrors the SAME shape the orchestrator already persisted
|
|
23184
|
+
* (the `pipeline-orchestrator.cap.ts` storage contract). Every field that
|
|
23185
|
+
* is only conditionally written is `.optional()`, so an existing blob
|
|
23186
|
+
* that predates a newer field still loads — durable-state `get()` only
|
|
23187
|
+
* falls back to the empty map on a whole-blob parse failure, so the
|
|
23188
|
+
* schema is kept faithful to the on-disk shape rather than overly strict.
|
|
23142
23189
|
*/
|
|
23143
|
-
|
|
23144
|
-
|
|
23145
|
-
|
|
23146
|
-
|
|
23147
|
-
|
|
23190
|
+
var EngineChoiceSchema = object({
|
|
23191
|
+
runtime: _enum(["node", "python"]),
|
|
23192
|
+
backend: string(),
|
|
23193
|
+
format: string(),
|
|
23194
|
+
device: string().optional()
|
|
23195
|
+
});
|
|
23196
|
+
var NodeBindingsSchema = record(string(), record(string(), string()));
|
|
23197
|
+
var StoredPipelineConfigSchema = object({
|
|
23198
|
+
engine: EngineChoiceSchema,
|
|
23199
|
+
steps: array(PipelineStepInputSchema).readonly(),
|
|
23200
|
+
audio: object({
|
|
23201
|
+
engine: EngineChoiceSchema,
|
|
23202
|
+
modelId: string(),
|
|
23203
|
+
enabled: boolean(),
|
|
23204
|
+
settings: record(string(), unknown()).readonly().optional()
|
|
23205
|
+
}).nullable().optional()
|
|
23206
|
+
});
|
|
23207
|
+
var StoredPipelineTemplateSchema = object({
|
|
23208
|
+
id: string(),
|
|
23209
|
+
name: string(),
|
|
23210
|
+
description: string().optional(),
|
|
23211
|
+
config: StoredPipelineConfigSchema,
|
|
23212
|
+
createdAt: string(),
|
|
23213
|
+
updatedAt: string()
|
|
23214
|
+
});
|
|
23215
|
+
var TemplatesSchema = record(string(), StoredPipelineTemplateSchema);
|
|
23216
|
+
var StoredAgentAddonConfigSchema = object({
|
|
23217
|
+
enabled: boolean(),
|
|
23218
|
+
modelId: string(),
|
|
23219
|
+
settings: record(string(), unknown()).readonly()
|
|
23220
|
+
});
|
|
23221
|
+
var StoredAgentPipelineSettingsSchema = object({
|
|
23222
|
+
addonDefaults: record(string(), StoredAgentAddonConfigSchema).readonly(),
|
|
23223
|
+
maxCameras: number().int().nonnegative().nullable().default(null)
|
|
23224
|
+
});
|
|
23225
|
+
var AgentSettingsMapSchema = record(string(), StoredAgentPipelineSettingsSchema);
|
|
23226
|
+
var StoredCameraStepOverridePatchSchema = object({
|
|
23227
|
+
enabled: boolean().optional(),
|
|
23228
|
+
modelId: string().optional(),
|
|
23229
|
+
settings: record(string(), unknown()).readonly().optional()
|
|
23230
|
+
});
|
|
23231
|
+
var StoredCameraPipelineForAgentSchema = object({
|
|
23232
|
+
steps: array(PipelineStepInputSchema).readonly(),
|
|
23233
|
+
audio: object({
|
|
23234
|
+
modelId: string(),
|
|
23235
|
+
enabled: boolean()
|
|
23236
|
+
}).nullable()
|
|
23237
|
+
});
|
|
23238
|
+
var StoredCameraPipelineSettingsSchema = object({
|
|
23239
|
+
pinnedAgentNodeId: string().optional(),
|
|
23240
|
+
stepToggles: record(string(), boolean()).optional(),
|
|
23241
|
+
stepOverridesByAgent: record(string(), record(string(), StoredCameraStepOverridePatchSchema)).optional(),
|
|
23242
|
+
pipelineByAgent: record(string(), StoredCameraPipelineForAgentSchema).optional(),
|
|
23243
|
+
/**
|
|
23244
|
+
* Legacy "nuke inference" flag. Superseded by the detection-pipeline
|
|
23245
|
+
* wrapper binding, but the one-shot boot migration
|
|
23246
|
+
* (`migrateLegacyFlagsToBindings`) still reads it off the persisted
|
|
23247
|
+
* blob to flip the binding off. Kept here so the durable round-trip
|
|
23248
|
+
* does NOT strip it before the migration runs.
|
|
23249
|
+
*/
|
|
23250
|
+
disableInference: boolean().optional()
|
|
23251
|
+
});
|
|
23252
|
+
var CameraSettingsMapSchema = record(string(), StoredCameraPipelineSettingsSchema);
|
|
23253
|
+
//#endregion
|
|
23254
|
+
//#region src/pending-retry.ts
|
|
23148
23255
|
/**
|
|
23149
|
-
* Returns the deviceIds that are present in `
|
|
23150
|
-
* `
|
|
23151
|
-
*
|
|
23256
|
+
* Returns the deviceIds that are KNOWN (present in `known`) but currently
|
|
23257
|
+
* UNASSIGNED (absent from `assigned`). These are the "stranded" cameras — the
|
|
23258
|
+
* orchestrator has a runner config for them but no live pipeline assignment
|
|
23259
|
+
* (pending / over-cap / no-frame-source / load-shed).
|
|
23152
23260
|
*
|
|
23153
|
-
*
|
|
23154
|
-
*
|
|
23261
|
+
* Mirror of `computeDispatchGap` in `dispatch-reconcile.ts`: a plain set
|
|
23262
|
+
* difference (`known \ assigned`). Pure — no side effects, deterministic
|
|
23263
|
+
* ordering (iteration order of `known`).
|
|
23155
23264
|
*/
|
|
23156
|
-
function
|
|
23157
|
-
return [...
|
|
23265
|
+
function computeStrandedDevices(known, assigned) {
|
|
23266
|
+
return [...known].filter((id) => !assigned.has(id));
|
|
23158
23267
|
}
|
|
23159
23268
|
//#endregion
|
|
23160
23269
|
//#region src/pipeline-watchdog.ts
|
|
@@ -23187,219 +23296,407 @@ var PipelineWatchdog = class {
|
|
|
23187
23296
|
});
|
|
23188
23297
|
this.state.set(cam.deviceId, stages);
|
|
23189
23298
|
}
|
|
23190
|
-
unregister(deviceId) {
|
|
23191
|
-
this.cameras.delete(deviceId);
|
|
23192
|
-
this.state.delete(deviceId);
|
|
23299
|
+
unregister(deviceId) {
|
|
23300
|
+
this.cameras.delete(deviceId);
|
|
23301
|
+
this.state.delete(deviceId);
|
|
23302
|
+
}
|
|
23303
|
+
/** Called when a stage's live signal arrives (audio chunk / motion frame / inference). */
|
|
23304
|
+
noteSignal(deviceId, stage) {
|
|
23305
|
+
const rt = this.state.get(deviceId)?.get(stage);
|
|
23306
|
+
if (!rt) return;
|
|
23307
|
+
rt.lastSeenMs = this.deps.now();
|
|
23308
|
+
rt.attempts = 0;
|
|
23309
|
+
}
|
|
23310
|
+
tick() {
|
|
23311
|
+
const now = this.deps.now();
|
|
23312
|
+
for (const cam of this.cameras.values()) {
|
|
23313
|
+
const { line, stalled, recoveries } = this.evaluate(cam, now);
|
|
23314
|
+
if (stalled) this.deps.logger.warn(line);
|
|
23315
|
+
else this.deps.logger.info(line);
|
|
23316
|
+
for (const r of recoveries) {
|
|
23317
|
+
const rt = this.state.get(cam.deviceId)?.get(r.stage);
|
|
23318
|
+
if (rt) rt.attempts += 1;
|
|
23319
|
+
this.deps.recover(cam.deviceId, r.stage, r.streamId);
|
|
23320
|
+
}
|
|
23321
|
+
}
|
|
23322
|
+
}
|
|
23323
|
+
start(intervalMs) {
|
|
23324
|
+
if (this.timer) return;
|
|
23325
|
+
this.timer = setInterval(() => this.tick(), intervalMs);
|
|
23326
|
+
}
|
|
23327
|
+
stop() {
|
|
23328
|
+
if (this.timer) clearInterval(this.timer);
|
|
23329
|
+
this.timer = null;
|
|
23330
|
+
}
|
|
23331
|
+
evaluate(cam, now) {
|
|
23332
|
+
const parts = [];
|
|
23333
|
+
const recoveries = [];
|
|
23334
|
+
let stalled = false;
|
|
23335
|
+
const stageOrder = [
|
|
23336
|
+
"audio",
|
|
23337
|
+
"motion",
|
|
23338
|
+
"detection"
|
|
23339
|
+
];
|
|
23340
|
+
const stageMode = {
|
|
23341
|
+
audio: cam.audioMode,
|
|
23342
|
+
motion: cam.motionSources.includes("analyzer") ? "analyzer" : cam.motionSources.join("+"),
|
|
23343
|
+
detection: cam.detectionMode
|
|
23344
|
+
};
|
|
23345
|
+
for (const stage of stageOrder) {
|
|
23346
|
+
const streamId = cam.continuousStages.get(stage);
|
|
23347
|
+
if (streamId === void 0) {
|
|
23348
|
+
parts.push(`${stage}=${stageMode[stage]}(idle)`);
|
|
23349
|
+
continue;
|
|
23350
|
+
}
|
|
23351
|
+
const rt = this.state.get(cam.deviceId)?.get(stage);
|
|
23352
|
+
if (!rt) {
|
|
23353
|
+
parts.push(`${stage}=${stageMode[stage]}(unknown)`);
|
|
23354
|
+
continue;
|
|
23355
|
+
}
|
|
23356
|
+
const staleness = now - rt.lastSeenMs;
|
|
23357
|
+
const thresholdMs = this.deps.thresholds[STAGE_THRESHOLD_KEY[stage]];
|
|
23358
|
+
const sSec = Math.round(staleness / 1e3);
|
|
23359
|
+
if (staleness <= thresholdMs) parts.push(`${stage}=${stageMode[stage]}@${streamId}(OK ${sSec}s)`);
|
|
23360
|
+
else if (rt.attempts >= this.deps.thresholds.maxRecoveryAttempts) {
|
|
23361
|
+
stalled = true;
|
|
23362
|
+
parts.push(`${stage}=${stageMode[stage]}@${streamId}(STALLED ${sSec}s · exhausted ${rt.attempts})`);
|
|
23363
|
+
} else {
|
|
23364
|
+
stalled = true;
|
|
23365
|
+
recoveries.push({
|
|
23366
|
+
stage,
|
|
23367
|
+
streamId
|
|
23368
|
+
});
|
|
23369
|
+
parts.push(`${stage}=${stageMode[stage]}@${streamId}(STALLED ${sSec}s · recovering ${rt.attempts + 1}/${this.deps.thresholds.maxRecoveryAttempts})`);
|
|
23370
|
+
}
|
|
23371
|
+
}
|
|
23372
|
+
return {
|
|
23373
|
+
line: `[watchdog] cam${cam.deviceId} ${cam.deviceName} · ${parts.join(" · ")} → ${stalled ? "STALLED" : "OK"}`,
|
|
23374
|
+
stalled,
|
|
23375
|
+
recoveries
|
|
23376
|
+
};
|
|
23377
|
+
}
|
|
23378
|
+
};
|
|
23379
|
+
//#endregion
|
|
23380
|
+
//#region src/remote-health.ts
|
|
23381
|
+
/**
|
|
23382
|
+
* Default thresholds: 3-min grace (cold start), 2-min stale window (metrics
|
|
23383
|
+
* stopped entirely), 0.5 fps floor. A degraded foreign-handle camera runs
|
|
23384
|
+
* ~1 fps (above the bar); with T2's frame-source eligibility a remote
|
|
23385
|
+
* assignment is only legal on a frame-source node, so sustained sub-0.5 fps
|
|
23386
|
+
* means genuinely broken.
|
|
23387
|
+
*/
|
|
23388
|
+
var DEFAULT_REMOTE_HEALTH_OPTS = {
|
|
23389
|
+
graceMs: 3 * 6e4,
|
|
23390
|
+
staleMs: 2 * 6e4,
|
|
23391
|
+
minFps: .5
|
|
23392
|
+
};
|
|
23393
|
+
/**
|
|
23394
|
+
* Evaluate every remote pipeline assignment and return the cameras that must be
|
|
23395
|
+
* re-placed. Rules (each assignment evaluated independently):
|
|
23396
|
+
* 1. LOCAL assignments (`agentNodeId === localNodeId`) are skipped — the hub
|
|
23397
|
+
* watchdog owns them.
|
|
23398
|
+
* 2. Cameras not in `activeDeviceIds` are skipped — detection isn't expected.
|
|
23399
|
+
* 3. Assignments younger than `graceMs` are skipped — cold-start grace.
|
|
23400
|
+
* 4. No fps entry, or `now - lastSeen > staleMs` → `stale-metrics`.
|
|
23401
|
+
* 5. Otherwise `fps < minFps` → `zero-fps`.
|
|
23402
|
+
* 6. Otherwise healthy → no action.
|
|
23403
|
+
*
|
|
23404
|
+
* Deterministic ordering: iteration order of `assignments`.
|
|
23405
|
+
*/
|
|
23406
|
+
function evaluateRemoteHealth(input) {
|
|
23407
|
+
const { assignments, fpsMap, activeDeviceIds, localNodeId, now, opts } = input;
|
|
23408
|
+
const actions = [];
|
|
23409
|
+
for (const [deviceId, assignment] of assignments) {
|
|
23410
|
+
if (assignment.agentNodeId === localNodeId) continue;
|
|
23411
|
+
if (!activeDeviceIds.has(deviceId)) continue;
|
|
23412
|
+
if (now - assignment.assignedAt < opts.graceMs) continue;
|
|
23413
|
+
const entry = fpsMap.get(deviceId);
|
|
23414
|
+
if (!entry || now - entry.lastSeen > opts.staleMs) {
|
|
23415
|
+
actions.push({
|
|
23416
|
+
deviceId,
|
|
23417
|
+
kind: "replace",
|
|
23418
|
+
why: "stale-metrics"
|
|
23419
|
+
});
|
|
23420
|
+
continue;
|
|
23421
|
+
}
|
|
23422
|
+
if (entry.fps < opts.minFps) {
|
|
23423
|
+
actions.push({
|
|
23424
|
+
deviceId,
|
|
23425
|
+
kind: "replace",
|
|
23426
|
+
why: "zero-fps"
|
|
23427
|
+
});
|
|
23428
|
+
continue;
|
|
23429
|
+
}
|
|
23430
|
+
}
|
|
23431
|
+
return actions;
|
|
23432
|
+
}
|
|
23433
|
+
//#endregion
|
|
23434
|
+
//#region src/zone-rules-provider.ts
|
|
23435
|
+
/**
|
|
23436
|
+
* `zone-rules-provider.ts` — implements `zoneRulesCapability` for the
|
|
23437
|
+
* orchestrator.
|
|
23438
|
+
*
|
|
23439
|
+
* Per-stage rule arrays (motion / detection) live next to zones in the
|
|
23440
|
+
* orchestrator's per-device store under `zoneRules.<stage>` keys.
|
|
23441
|
+
* Every mutation mirrors to a stage-specific device-state slice
|
|
23442
|
+
* (`motion-zone-rules`, `detection-zone-rules`) so consumer addons
|
|
23443
|
+
* subscribe independently and pick up the new gating without an extra
|
|
23444
|
+
* cap round-trip.
|
|
23445
|
+
*
|
|
23446
|
+
* The provider validates each rule against {@link ZoneRuleSchema}
|
|
23447
|
+
* before persisting — partial / corrupt writes are rejected outright
|
|
23448
|
+
* since rules drive runtime filtering and a bad payload would silently
|
|
23449
|
+
* widen the operator's intended scope.
|
|
23450
|
+
*/
|
|
23451
|
+
/** Settings store key for stage rules. Kept under a single nested
|
|
23452
|
+
* object so a future stage just adds another property without
|
|
23453
|
+
* reshuffling the schema. */
|
|
23454
|
+
var RULES_STORE_KEY = "zoneRules";
|
|
23455
|
+
/** Cap name for the unified runtime-state slice. Matches the cap's
|
|
23456
|
+
* declared `name` so the codegen DeviceProxy auto-wires
|
|
23457
|
+
* `device.state.zoneRules`. The slice value is the full
|
|
23458
|
+
* `{motion, detection}` object — both stages travel together so a
|
|
23459
|
+
* single reactive handle covers every consumer. */
|
|
23460
|
+
var ZONE_RULES_CAP_NAME = "zone-rules";
|
|
23461
|
+
var RulesArraySchema = array(ZoneRuleSchema);
|
|
23462
|
+
/**
|
|
23463
|
+
* Whole-blob schema for the per-device `zoneRules` store key. Both stages
|
|
23464
|
+
* travel together under one key. Deliberately lenient — each stage is
|
|
23465
|
+
* `unknown` so a corrupt single stage can NOT drop the sibling on load
|
|
23466
|
+
* (durable-state `get()` falls back to `{}` only on a whole-blob parse
|
|
23467
|
+
* failure). Strict per-stage validation, with its own reset-on-corrupt
|
|
23468
|
+
* warn, still happens in `loadRules` exactly as before the migration.
|
|
23469
|
+
*/
|
|
23470
|
+
var ZoneRulesBlockSchema = object({
|
|
23471
|
+
motion: unknown().optional(),
|
|
23472
|
+
detection: unknown().optional()
|
|
23473
|
+
}).passthrough();
|
|
23474
|
+
var ZoneRulesProvider = class {
|
|
23475
|
+
ctx;
|
|
23476
|
+
/** Per-device per-stage cache. Hydrated lazily on first read. */
|
|
23477
|
+
cache = /* @__PURE__ */ new Map();
|
|
23478
|
+
/**
|
|
23479
|
+
* Per-device durable handle over the `zoneRules` store key. The WHOLE
|
|
23480
|
+
* `{motion?, detection?}` block round-trips on every read/write so a
|
|
23481
|
+
* write on one stage can never drop the other. Built lazily + memoised.
|
|
23482
|
+
*/
|
|
23483
|
+
stateByDevice = /* @__PURE__ */ new Map();
|
|
23484
|
+
constructor(ctx) {
|
|
23485
|
+
this.ctx = ctx;
|
|
23486
|
+
}
|
|
23487
|
+
/** Lazily build (and memoise) the durable `zoneRules` handle for a device. */
|
|
23488
|
+
rulesState(deviceId) {
|
|
23489
|
+
let handle = this.stateByDevice.get(deviceId);
|
|
23490
|
+
if (!handle) {
|
|
23491
|
+
handle = createDurableState({
|
|
23492
|
+
key: RULES_STORE_KEY,
|
|
23493
|
+
schema: ZoneRulesBlockSchema,
|
|
23494
|
+
fallback: {},
|
|
23495
|
+
read: () => this.ctx.settings.readDeviceStore(deviceId),
|
|
23496
|
+
write: (patch) => this.ctx.settings.writeDeviceStore(deviceId, patch),
|
|
23497
|
+
onParseError: (key, error) => this.ctx.logger.warn("zone-rules store block failed to parse — resetting", {
|
|
23498
|
+
tags: { deviceId },
|
|
23499
|
+
meta: {
|
|
23500
|
+
key,
|
|
23501
|
+
error: error instanceof Error ? error.message : String(error)
|
|
23502
|
+
}
|
|
23503
|
+
})
|
|
23504
|
+
});
|
|
23505
|
+
this.stateByDevice.set(deviceId, handle);
|
|
23506
|
+
}
|
|
23507
|
+
return handle;
|
|
23508
|
+
}
|
|
23509
|
+
async listRules({ deviceId, stage }) {
|
|
23510
|
+
return this.loadRules(deviceId, stage);
|
|
23511
|
+
}
|
|
23512
|
+
async setRules({ deviceId, stage, rules }) {
|
|
23513
|
+
const parsed = RulesArraySchema.safeParse(rules);
|
|
23514
|
+
if (!parsed.success) throw new Error(`zone-rules.setRules: invalid rule payload — ${parsed.error.issues.map((i) => i.message).join("; ")}`);
|
|
23515
|
+
await this.persist(deviceId, stage, parsed.data);
|
|
23193
23516
|
}
|
|
23194
|
-
/**
|
|
23195
|
-
|
|
23196
|
-
|
|
23197
|
-
|
|
23198
|
-
rt.lastSeenMs = this.deps.now();
|
|
23199
|
-
rt.attempts = 0;
|
|
23517
|
+
/** Drop a device's cache entries. Called when the device is removed. */
|
|
23518
|
+
forgetDevice(deviceId) {
|
|
23519
|
+
this.cache.delete(deviceId);
|
|
23520
|
+
this.stateByDevice.delete(deviceId);
|
|
23200
23521
|
}
|
|
23201
|
-
|
|
23202
|
-
|
|
23203
|
-
|
|
23204
|
-
|
|
23205
|
-
|
|
23206
|
-
|
|
23207
|
-
|
|
23208
|
-
|
|
23209
|
-
|
|
23210
|
-
|
|
23522
|
+
async loadRules(deviceId, stage) {
|
|
23523
|
+
let perDevice = this.cache.get(deviceId);
|
|
23524
|
+
if (!perDevice) {
|
|
23525
|
+
perDevice = /* @__PURE__ */ new Map();
|
|
23526
|
+
this.cache.set(deviceId, perDevice);
|
|
23527
|
+
}
|
|
23528
|
+
const cached = perDevice.get(stage);
|
|
23529
|
+
if (cached) return cached;
|
|
23530
|
+
let rules = [];
|
|
23531
|
+
try {
|
|
23532
|
+
const raw = (await this.rulesState(deviceId).get())[stage];
|
|
23533
|
+
if (raw !== void 0) {
|
|
23534
|
+
const parsed = RulesArraySchema.safeParse(raw);
|
|
23535
|
+
if (parsed.success) rules = parsed.data;
|
|
23536
|
+
else this.ctx.logger.warn("zone-rules store entry failed to parse — resetting", {
|
|
23537
|
+
tags: { deviceId },
|
|
23538
|
+
meta: {
|
|
23539
|
+
stage,
|
|
23540
|
+
issues: parsed.error.issues
|
|
23541
|
+
}
|
|
23542
|
+
});
|
|
23211
23543
|
}
|
|
23544
|
+
} catch (err) {
|
|
23545
|
+
this.ctx.logger.warn("zone-rules store read failed — using empty list", {
|
|
23546
|
+
tags: { deviceId },
|
|
23547
|
+
meta: {
|
|
23548
|
+
stage,
|
|
23549
|
+
error: err instanceof Error ? err.message : String(err)
|
|
23550
|
+
}
|
|
23551
|
+
});
|
|
23212
23552
|
}
|
|
23553
|
+
perDevice.set(stage, rules);
|
|
23554
|
+
return rules;
|
|
23213
23555
|
}
|
|
23214
|
-
|
|
23215
|
-
|
|
23216
|
-
|
|
23217
|
-
|
|
23218
|
-
|
|
23219
|
-
|
|
23220
|
-
|
|
23221
|
-
|
|
23222
|
-
|
|
23223
|
-
|
|
23224
|
-
|
|
23225
|
-
|
|
23226
|
-
const
|
|
23227
|
-
|
|
23228
|
-
|
|
23229
|
-
|
|
23230
|
-
|
|
23231
|
-
|
|
23232
|
-
|
|
23233
|
-
motion: cam.motionSources.includes("analyzer") ? "analyzer" : cam.motionSources.join("+"),
|
|
23234
|
-
detection: cam.detectionMode
|
|
23556
|
+
async persist(deviceId, stage, rules) {
|
|
23557
|
+
let perDevice = this.cache.get(deviceId);
|
|
23558
|
+
if (!perDevice) {
|
|
23559
|
+
perDevice = /* @__PURE__ */ new Map();
|
|
23560
|
+
this.cache.set(deviceId, perDevice);
|
|
23561
|
+
}
|
|
23562
|
+
perDevice.set(stage, rules);
|
|
23563
|
+
await this.rulesState(deviceId).update((prev) => ({
|
|
23564
|
+
...prev,
|
|
23565
|
+
[stage]: rules
|
|
23566
|
+
}));
|
|
23567
|
+
const otherStage = stage === "motion" ? "detection" : "motion";
|
|
23568
|
+
const otherRules = perDevice.get(otherStage) ?? await this.loadRules(deviceId, otherStage);
|
|
23569
|
+
const sliceValue = stage === "motion" ? {
|
|
23570
|
+
motion: rules,
|
|
23571
|
+
detection: otherRules
|
|
23572
|
+
} : {
|
|
23573
|
+
motion: otherRules,
|
|
23574
|
+
detection: rules
|
|
23235
23575
|
};
|
|
23236
|
-
|
|
23237
|
-
|
|
23238
|
-
|
|
23239
|
-
|
|
23240
|
-
|
|
23241
|
-
|
|
23242
|
-
|
|
23243
|
-
|
|
23244
|
-
|
|
23245
|
-
continue;
|
|
23246
|
-
}
|
|
23247
|
-
const staleness = now - rt.lastSeenMs;
|
|
23248
|
-
const thresholdMs = this.deps.thresholds[STAGE_THRESHOLD_KEY[stage]];
|
|
23249
|
-
const sSec = Math.round(staleness / 1e3);
|
|
23250
|
-
if (staleness <= thresholdMs) parts.push(`${stage}=${stageMode[stage]}@${streamId}(OK ${sSec}s)`);
|
|
23251
|
-
else if (rt.attempts >= this.deps.thresholds.maxRecoveryAttempts) {
|
|
23252
|
-
stalled = true;
|
|
23253
|
-
parts.push(`${stage}=${stageMode[stage]}@${streamId}(STALLED ${sSec}s · exhausted ${rt.attempts})`);
|
|
23254
|
-
} else {
|
|
23255
|
-
stalled = true;
|
|
23256
|
-
recoveries.push({
|
|
23576
|
+
try {
|
|
23577
|
+
await (await this.ctx.fetchDevice(deviceId)).deviceState.setCapSlice({
|
|
23578
|
+
capName: ZONE_RULES_CAP_NAME,
|
|
23579
|
+
slice: sliceValue
|
|
23580
|
+
});
|
|
23581
|
+
} catch (err) {
|
|
23582
|
+
this.ctx.logger.debug("zone-rules slice mirror failed", {
|
|
23583
|
+
tags: { deviceId },
|
|
23584
|
+
meta: {
|
|
23257
23585
|
stage,
|
|
23258
|
-
|
|
23259
|
-
}
|
|
23260
|
-
|
|
23261
|
-
}
|
|
23586
|
+
error: err instanceof Error ? err.message : String(err)
|
|
23587
|
+
}
|
|
23588
|
+
});
|
|
23262
23589
|
}
|
|
23263
|
-
|
|
23264
|
-
line: `[watchdog] cam${cam.deviceId} ${cam.deviceName} · ${parts.join(" · ")} → ${stalled ? "STALLED" : "OK"}`,
|
|
23265
|
-
stalled,
|
|
23266
|
-
recoveries
|
|
23267
|
-
};
|
|
23590
|
+
this.ctx.onRulesChanged?.(deviceId, stage, rules);
|
|
23268
23591
|
}
|
|
23269
23592
|
};
|
|
23270
23593
|
//#endregion
|
|
23271
|
-
//#region src/
|
|
23272
|
-
function mapAssignment(input) {
|
|
23273
|
-
return {
|
|
23274
|
-
detectionNodeId: input.detectionNodeId,
|
|
23275
|
-
decoderNodeId: input.decoderNodeId,
|
|
23276
|
-
audioNodeId: input.audioNodeId,
|
|
23277
|
-
pinned: {
|
|
23278
|
-
detection: input.pinned.detection,
|
|
23279
|
-
decoder: input.pinned.decoder,
|
|
23280
|
-
audio: input.pinned.audio
|
|
23281
|
-
},
|
|
23282
|
-
reasons: {
|
|
23283
|
-
detection: input.reasons.detection,
|
|
23284
|
-
decoder: input.reasons.decoder,
|
|
23285
|
-
audio: input.reasons.audio
|
|
23286
|
-
}
|
|
23287
|
-
};
|
|
23288
|
-
}
|
|
23289
|
-
function mapSource(sourceResult) {
|
|
23290
|
-
if (sourceResult === null) return { streams: [] };
|
|
23291
|
-
return { streams: sourceResult.streams.map((s) => ({
|
|
23292
|
-
camStreamId: s.camStreamId,
|
|
23293
|
-
codec: s.codec,
|
|
23294
|
-
width: s.width,
|
|
23295
|
-
height: s.height,
|
|
23296
|
-
fps: s.fps,
|
|
23297
|
-
kind: s.kind
|
|
23298
|
-
})) };
|
|
23299
|
-
}
|
|
23300
|
-
function mapBroker(brokerResult) {
|
|
23301
|
-
if (brokerResult === null) return null;
|
|
23302
|
-
return {
|
|
23303
|
-
profiles: brokerResult.profiles.map((p) => ({
|
|
23304
|
-
profile: p.profile,
|
|
23305
|
-
status: p.status,
|
|
23306
|
-
codec: p.codec,
|
|
23307
|
-
width: p.width,
|
|
23308
|
-
height: p.height,
|
|
23309
|
-
subscribers: p.subscribers,
|
|
23310
|
-
inFps: p.inFps,
|
|
23311
|
-
outFps: p.outFps
|
|
23312
|
-
})),
|
|
23313
|
-
webrtcSessions: brokerResult.webrtcSessions,
|
|
23314
|
-
rtspRestream: brokerResult.rtspRestream
|
|
23315
|
-
};
|
|
23316
|
-
}
|
|
23317
|
-
function mapDecoderShm(shm) {
|
|
23318
|
-
return {
|
|
23319
|
-
framesWritten: shm.framesWritten,
|
|
23320
|
-
getFrameHits: shm.getFrameHits,
|
|
23321
|
-
getFrameMisses: shm.getFrameMisses,
|
|
23322
|
-
budgetMb: shm.budgetMb
|
|
23323
|
-
};
|
|
23324
|
-
}
|
|
23325
|
-
function mapDecoder(decoderResult) {
|
|
23326
|
-
if (decoderResult === null) return null;
|
|
23327
|
-
return {
|
|
23328
|
-
nodeId: decoderResult.nodeId,
|
|
23329
|
-
formats: [...decoderResult.formats],
|
|
23330
|
-
sessionCount: decoderResult.sessionCount,
|
|
23331
|
-
shm: mapDecoderShm(decoderResult.shm)
|
|
23332
|
-
};
|
|
23333
|
-
}
|
|
23334
|
-
function mapMotion(motionResult) {
|
|
23335
|
-
if (motionResult === null) return null;
|
|
23336
|
-
return {
|
|
23337
|
-
enabled: motionResult.enabled,
|
|
23338
|
-
fps: motionResult.fps
|
|
23339
|
-
};
|
|
23340
|
-
}
|
|
23341
|
-
function mapProvisioning(p) {
|
|
23342
|
-
if (p.error !== void 0) return {
|
|
23343
|
-
state: p.state,
|
|
23344
|
-
error: p.error
|
|
23345
|
-
};
|
|
23346
|
-
return { state: p.state };
|
|
23347
|
-
}
|
|
23348
|
-
function mapDetection(detectionResult) {
|
|
23349
|
-
if (detectionResult === null) return null;
|
|
23350
|
-
const phase = detectionResult.phase;
|
|
23351
|
-
return {
|
|
23352
|
-
nodeId: detectionResult.nodeId,
|
|
23353
|
-
engine: {
|
|
23354
|
-
backend: detectionResult.engine.backend,
|
|
23355
|
-
device: detectionResult.engine.device
|
|
23356
|
-
},
|
|
23357
|
-
phase,
|
|
23358
|
-
configuredFps: detectionResult.configuredFps,
|
|
23359
|
-
actualFps: detectionResult.actualFps,
|
|
23360
|
-
queueDepth: detectionResult.queueDepth,
|
|
23361
|
-
avgInferenceMs: detectionResult.avgInferenceMs,
|
|
23362
|
-
provisioning: mapProvisioning(detectionResult.provisioning)
|
|
23363
|
-
};
|
|
23364
|
-
}
|
|
23365
|
-
function mapAudio(audioResult) {
|
|
23366
|
-
if (audioResult === null) return null;
|
|
23367
|
-
return {
|
|
23368
|
-
nodeId: audioResult.nodeId,
|
|
23369
|
-
enabled: audioResult.enabled
|
|
23370
|
-
};
|
|
23371
|
-
}
|
|
23372
|
-
function mapRecording(recordingResult) {
|
|
23373
|
-
if (recordingResult === null) return null;
|
|
23374
|
-
return {
|
|
23375
|
-
mode: recordingResult.mode,
|
|
23376
|
-
active: recordingResult.active,
|
|
23377
|
-
storageBytes: recordingResult.storageBytes
|
|
23378
|
-
};
|
|
23379
|
-
}
|
|
23594
|
+
//#region src/zones-provider.ts
|
|
23380
23595
|
/**
|
|
23381
|
-
*
|
|
23596
|
+
* `zones-provider.ts` — implements `zonesCapability` for the orchestrator.
|
|
23597
|
+
*
|
|
23598
|
+
* Per-camera CRUD over polygon detection zones. Persists to the
|
|
23599
|
+
* orchestrator's per-device settings store under the `zones` key and
|
|
23600
|
+
* mirrors every change into the device-state `zones` slice via
|
|
23601
|
+
* `api.deviceState.setCapSlice`. Downstream consumers (motion-wasm,
|
|
23602
|
+
* pipeline-executor, analytics, admin UI) read the live state with
|
|
23603
|
+
* the canonical `dev.state.zones.onChanged` channel.
|
|
23382
23604
|
*
|
|
23383
|
-
* -
|
|
23384
|
-
* -
|
|
23385
|
-
*
|
|
23386
|
-
*
|
|
23387
|
-
* - No mutation of the input.
|
|
23605
|
+
* Onboard / firmware-reported zones are out of scope for now — every
|
|
23606
|
+
* zone is operator-drawn. The provider keeps the surface symmetric:
|
|
23607
|
+
* `addZone` rejects id collisions, `updateZone` requires an existing
|
|
23608
|
+
* id, `removeZone` is idempotent.
|
|
23388
23609
|
*/
|
|
23389
|
-
|
|
23390
|
-
|
|
23391
|
-
|
|
23392
|
-
|
|
23393
|
-
|
|
23394
|
-
|
|
23395
|
-
|
|
23396
|
-
|
|
23397
|
-
|
|
23398
|
-
|
|
23399
|
-
|
|
23400
|
-
|
|
23401
|
-
|
|
23402
|
-
|
|
23610
|
+
var ZONES_STORE_KEY = "zones";
|
|
23611
|
+
var ZONES_CAP_NAME = "zones";
|
|
23612
|
+
var ZonesArraySchema = array(ZoneSchema);
|
|
23613
|
+
var ZonesProvider = class {
|
|
23614
|
+
ctx;
|
|
23615
|
+
/** Per-device cache. Hydrated lazily on first read for a device. */
|
|
23616
|
+
cache = /* @__PURE__ */ new Map();
|
|
23617
|
+
/**
|
|
23618
|
+
* Per-device durable handle over the `zones` store key. The WHOLE
|
|
23619
|
+
* validated zone array round-trips on every read/write so no field can
|
|
23620
|
+
* be dropped on persist. Built lazily + memoised per device.
|
|
23621
|
+
*/
|
|
23622
|
+
stateByDevice = /* @__PURE__ */ new Map();
|
|
23623
|
+
constructor(ctx) {
|
|
23624
|
+
this.ctx = ctx;
|
|
23625
|
+
}
|
|
23626
|
+
/** Lazily build (and memoise) the durable `zones` handle for a device. */
|
|
23627
|
+
zonesState(deviceId) {
|
|
23628
|
+
let handle = this.stateByDevice.get(deviceId);
|
|
23629
|
+
if (!handle) {
|
|
23630
|
+
handle = createDurableState({
|
|
23631
|
+
key: ZONES_STORE_KEY,
|
|
23632
|
+
schema: ZonesArraySchema,
|
|
23633
|
+
fallback: [],
|
|
23634
|
+
read: () => this.ctx.settings.readDeviceStore(deviceId),
|
|
23635
|
+
write: (patch) => this.ctx.settings.writeDeviceStore(deviceId, patch),
|
|
23636
|
+
onParseError: (key, error) => this.ctx.logger.warn("zones store entry failed to parse — resetting", {
|
|
23637
|
+
tags: { deviceId },
|
|
23638
|
+
meta: {
|
|
23639
|
+
key,
|
|
23640
|
+
error: error instanceof Error ? error.message : String(error)
|
|
23641
|
+
}
|
|
23642
|
+
})
|
|
23643
|
+
});
|
|
23644
|
+
this.stateByDevice.set(deviceId, handle);
|
|
23645
|
+
}
|
|
23646
|
+
return handle;
|
|
23647
|
+
}
|
|
23648
|
+
async listZones({ deviceId }) {
|
|
23649
|
+
return this.loadZones(deviceId);
|
|
23650
|
+
}
|
|
23651
|
+
async addZone({ deviceId, zone }) {
|
|
23652
|
+
const existing = await this.loadZones(deviceId);
|
|
23653
|
+
if (existing.some((entry) => entry.id === zone.id)) throw new Error(`zones.addZone: id ${zone.id} already exists`);
|
|
23654
|
+
await this.persist(deviceId, [...existing, zone]);
|
|
23655
|
+
}
|
|
23656
|
+
async updateZone({ deviceId, zone }) {
|
|
23657
|
+
const existing = await this.loadZones(deviceId);
|
|
23658
|
+
if (!existing.some((entry) => entry.id === zone.id)) throw new Error(`zones.updateZone: id ${zone.id} not found`);
|
|
23659
|
+
const next = existing.map((entry) => entry.id === zone.id ? zone : entry);
|
|
23660
|
+
await this.persist(deviceId, next);
|
|
23661
|
+
}
|
|
23662
|
+
async removeZone({ deviceId, zoneId }) {
|
|
23663
|
+
const existing = await this.loadZones(deviceId);
|
|
23664
|
+
if (!existing.some((entry) => entry.id === zoneId)) return;
|
|
23665
|
+
await this.persist(deviceId, existing.filter((entry) => entry.id !== zoneId));
|
|
23666
|
+
}
|
|
23667
|
+
/**
|
|
23668
|
+
* Drop a device's cache entry. Called when the device is removed so
|
|
23669
|
+
* the next attach starts from a fresh disk read.
|
|
23670
|
+
*/
|
|
23671
|
+
forgetDevice(deviceId) {
|
|
23672
|
+
this.cache.delete(deviceId);
|
|
23673
|
+
this.stateByDevice.delete(deviceId);
|
|
23674
|
+
}
|
|
23675
|
+
async loadZones(deviceId) {
|
|
23676
|
+
const cached = this.cache.get(deviceId);
|
|
23677
|
+
if (cached) return cached;
|
|
23678
|
+
let zones = [];
|
|
23679
|
+
try {
|
|
23680
|
+
zones = await this.zonesState(deviceId).get();
|
|
23681
|
+
} catch (err) {
|
|
23682
|
+
this.ctx.logger.warn("zones store read failed — using empty list", {
|
|
23683
|
+
tags: { deviceId },
|
|
23684
|
+
meta: { error: err instanceof Error ? err.message : String(err) }
|
|
23685
|
+
});
|
|
23686
|
+
}
|
|
23687
|
+
this.cache.set(deviceId, zones);
|
|
23688
|
+
return zones;
|
|
23689
|
+
}
|
|
23690
|
+
async persist(deviceId, zones) {
|
|
23691
|
+
this.cache.set(deviceId, zones);
|
|
23692
|
+
await this.zonesState(deviceId).set(zones);
|
|
23693
|
+
await (await this.ctx.fetchDevice(deviceId)).deviceState.setCapSlice({
|
|
23694
|
+
capName: ZONES_CAP_NAME,
|
|
23695
|
+
slice: { zones }
|
|
23696
|
+
});
|
|
23697
|
+
this.ctx.onZonesChanged?.(deviceId, zones);
|
|
23698
|
+
}
|
|
23699
|
+
};
|
|
23403
23700
|
//#endregion
|
|
23404
23701
|
//#region src/index.ts
|
|
23405
23702
|
var PHASE_MODE_VALUES = new Set([
|
|
@@ -23418,6 +23715,24 @@ var DEFAULT_BROKER_CALL_TIMEOUT_MS = 5e3;
|
|
|
23418
23715
|
/** Debounce window for `scheduleReconcile` — coalesces bursts of topology/slot-change signals. */
|
|
23419
23716
|
var RECONCILE_DEBOUNCE_MS = 200;
|
|
23420
23717
|
/**
|
|
23718
|
+
* Periodic sweep interval for `retryPendingDispatches` — re-dispatches cameras
|
|
23719
|
+
* that are KNOWN but UNASSIGNED (pending/over-cap/no-frame-source/load-shed).
|
|
23720
|
+
* `reconcileDispatch` is additive-only and never revisits these, so a slow
|
|
23721
|
+
* safety-net timer + event-driven debounce triggers recover them.
|
|
23722
|
+
*/
|
|
23723
|
+
var PENDING_RETRY_INTERVAL_MS = 6e4;
|
|
23724
|
+
/** Debounce window for `schedulePendingRetry` — coalesces capacity/eligibility/readiness signals. */
|
|
23725
|
+
var PENDING_RETRY_DEBOUNCE_MS = 2e3;
|
|
23726
|
+
/**
|
|
23727
|
+
* Remote-assignment health loop (T7) bounded backoff. A remote camera flagged
|
|
23728
|
+
* as unhealthy (0-fps / metrics-stale) is re-placed at most
|
|
23729
|
+
* `REMOTE_HEALTH_MAX_ATTEMPTS` times inside a rolling `REMOTE_HEALTH_WINDOW_MS`
|
|
23730
|
+
* window; once exhausted the camera is left visibly pending (`'unhealthy'`) for
|
|
23731
|
+
* the operator instead of churning forever.
|
|
23732
|
+
*/
|
|
23733
|
+
var REMOTE_HEALTH_MAX_ATTEMPTS = 3;
|
|
23734
|
+
var REMOTE_HEALTH_WINDOW_MS = 60 * 6e4;
|
|
23735
|
+
/**
|
|
23421
23736
|
* Device-details keys routed through the orchestrator's pipeline
|
|
23422
23737
|
* settings writer instead of the device orchestration store. The
|
|
23423
23738
|
* `cameraPipeline` key carries the full `CameraPipelineConfig`
|
|
@@ -23506,6 +23821,28 @@ var PipelineOrchestratorAddon = class PipelineOrchestratorAddon extends BaseAddo
|
|
|
23506
23821
|
zoneRulesProvider = null;
|
|
23507
23822
|
/** In-memory assignment map — mirrored into events + per-device settings for the pin. */
|
|
23508
23823
|
assignments = /* @__PURE__ */ new Map();
|
|
23824
|
+
/**
|
|
23825
|
+
* Why a camera is currently unassigned (pending), keyed by deviceId. Set on
|
|
23826
|
+
* every pending placement path (over-cap, no-frame-source, load-shed) and
|
|
23827
|
+
* cleared when the camera is (re)assigned or released. Consumed by T3's
|
|
23828
|
+
* pending-retry sweep + `getCameraStatus` surface — nothing reads it yet in
|
|
23829
|
+
* this commit; the map is populated so T3 can wire the read side without
|
|
23830
|
+
* re-touching every placement path.
|
|
23831
|
+
*
|
|
23832
|
+
* `protected` (not `private`) to match the existing test-seam convention in
|
|
23833
|
+
* this class (`audioSubscriptions`, `audioSubLocks`) — the frame-source
|
|
23834
|
+
* eligibility spec subclasses the addon to assert the recorded reason.
|
|
23835
|
+
*/
|
|
23836
|
+
pendingReasons = /* @__PURE__ */ new Map();
|
|
23837
|
+
/**
|
|
23838
|
+
* Remote-assignment health loop (T7) per-device backoff ledger. Each entry
|
|
23839
|
+
* tracks how many times a remote camera has been re-placed inside the current
|
|
23840
|
+
* rolling window (`REMOTE_HEALTH_WINDOW_MS`). Bounds churn: once the count
|
|
23841
|
+
* hits `REMOTE_HEALTH_MAX_ATTEMPTS`, the camera is left pending (`'unhealthy'`)
|
|
23842
|
+
* for the operator instead of being re-placed again. `protected` so the
|
|
23843
|
+
* remote-health spec can assert the ledger without casts.
|
|
23844
|
+
*/
|
|
23845
|
+
remoteHealthAttempts = /* @__PURE__ */ new Map();
|
|
23509
23846
|
/** Per-device audio node assignment — nodeId of the audio-analyzer handling this device's chunks. */
|
|
23510
23847
|
audioNodeByDevice = /* @__PURE__ */ new Map();
|
|
23511
23848
|
/** Assignments with metadata — replaces plain audioNodeByDevice values as the source of truth. */
|
|
@@ -23625,6 +23962,14 @@ var PipelineOrchestratorAddon = class PipelineOrchestratorAddon extends BaseAddo
|
|
|
23625
23962
|
reconcileInFlight = false;
|
|
23626
23963
|
/** Set to true when a reconcile is requested while one is already in-flight; triggers a follow-up pass. */
|
|
23627
23964
|
reconcileRerunRequested = false;
|
|
23965
|
+
/** Periodic `retryPendingDispatches` safety-net timer (T3). */
|
|
23966
|
+
pendingRetryTimer = null;
|
|
23967
|
+
/** Pending `schedulePendingRetry` debounce timer (T3). */
|
|
23968
|
+
pendingRetryDebounceTimer = null;
|
|
23969
|
+
/** True while `retryPendingDispatches` is running. */
|
|
23970
|
+
pendingRetryInFlight = false;
|
|
23971
|
+
/** Set when a pending-retry is requested while one is already in-flight; triggers a follow-up pass. */
|
|
23972
|
+
pendingRetryRerunRequested = false;
|
|
23628
23973
|
initTimestamp = 0;
|
|
23629
23974
|
constructor() {
|
|
23630
23975
|
super({});
|
|
@@ -23841,6 +24186,7 @@ var PipelineOrchestratorAddon = class PipelineOrchestratorAddon extends BaseAddo
|
|
|
23841
24186
|
thresholds: DEFAULT_WATCHDOG_THRESHOLDS
|
|
23842
24187
|
});
|
|
23843
24188
|
this.pipelineWatchdog.start(PipelineOrchestratorAddon.WATCHDOG_INTERVAL_MS);
|
|
24189
|
+
this.pendingRetryTimer = setInterval(() => void this.retryPendingDispatches(), PENDING_RETRY_INTERVAL_MS);
|
|
23844
24190
|
this.ctx.logger.info("Pipeline orchestrator detection-wiring subscriptions installed");
|
|
23845
24191
|
this.migrateLegacyFlagsToBindings().catch((err) => {
|
|
23846
24192
|
this.ctx.logger.warn("bindings migration failed — will retry on next boot", { meta: { error: errMsg(err) } });
|
|
@@ -24070,6 +24416,14 @@ var PipelineOrchestratorAddon = class PipelineOrchestratorAddon extends BaseAddo
|
|
|
24070
24416
|
clearTimeout(this.reconcileTimer);
|
|
24071
24417
|
this.reconcileTimer = null;
|
|
24072
24418
|
}
|
|
24419
|
+
if (this.pendingRetryTimer !== null) {
|
|
24420
|
+
clearInterval(this.pendingRetryTimer);
|
|
24421
|
+
this.pendingRetryTimer = null;
|
|
24422
|
+
}
|
|
24423
|
+
if (this.pendingRetryDebounceTimer !== null) {
|
|
24424
|
+
clearTimeout(this.pendingRetryDebounceTimer);
|
|
24425
|
+
this.pendingRetryDebounceTimer = null;
|
|
24426
|
+
}
|
|
24073
24427
|
this.unsubDeviceRegistered?.();
|
|
24074
24428
|
this.unsubDeviceRegistered = null;
|
|
24075
24429
|
this.unsubDeviceUnregistered?.();
|
|
@@ -24095,6 +24449,7 @@ var PipelineOrchestratorAddon = class PipelineOrchestratorAddon extends BaseAddo
|
|
|
24095
24449
|
for (const t of this.lazyAudioTeardownTimers.values()) clearTimeout(t);
|
|
24096
24450
|
this.lazyAudioTeardownTimers.clear();
|
|
24097
24451
|
this.cameraFpsMap.clear();
|
|
24452
|
+
this.remoteHealthAttempts.clear();
|
|
24098
24453
|
this.loadShedState.clear();
|
|
24099
24454
|
if (this.loadShedResumeTimer) {
|
|
24100
24455
|
clearInterval(this.loadShedResumeTimer);
|
|
@@ -24156,6 +24511,7 @@ var PipelineOrchestratorAddon = class PipelineOrchestratorAddon extends BaseAddo
|
|
|
24156
24511
|
windowMs
|
|
24157
24512
|
}
|
|
24158
24513
|
});
|
|
24514
|
+
this.pendingReasons.set(runnerConfig.deviceId, "load-shed");
|
|
24159
24515
|
return {
|
|
24160
24516
|
success: true,
|
|
24161
24517
|
kind: "pending"
|
|
@@ -24169,11 +24525,16 @@ var PipelineOrchestratorAddon = class PipelineOrchestratorAddon extends BaseAddo
|
|
|
24169
24525
|
const decision = balance({
|
|
24170
24526
|
nodes: await this.collectAgentLoad({ onlyEnabled: true }),
|
|
24171
24527
|
preferredAgent,
|
|
24172
|
-
nodeCaps: this.buildNodeCaps()
|
|
24528
|
+
nodeCaps: await this.buildNodeCaps(),
|
|
24529
|
+
eligibleNodes: this.detectionEligibleNodes()
|
|
24173
24530
|
});
|
|
24174
24531
|
if (!decision) throw new Error(`dispatchCamera: no runner available for ${runnerConfig.deviceId}`);
|
|
24175
24532
|
if (decision.kind === "pending") {
|
|
24176
|
-
this.
|
|
24533
|
+
this.pendingReasons.set(runnerConfig.deviceId, decision.reason);
|
|
24534
|
+
this.ctx.logger.warn("camera left pending — no eligible node", {
|
|
24535
|
+
tags: { deviceId: runnerConfig.deviceId },
|
|
24536
|
+
meta: { reason: decision.reason }
|
|
24537
|
+
});
|
|
24177
24538
|
return {
|
|
24178
24539
|
success: true,
|
|
24179
24540
|
kind: "pending"
|
|
@@ -24224,11 +24585,14 @@ var PipelineOrchestratorAddon = class PipelineOrchestratorAddon extends BaseAddo
|
|
|
24224
24585
|
}
|
|
24225
24586
|
this.assignments.delete(input.deviceId);
|
|
24226
24587
|
this.cameraConfigs.delete(input.deviceId);
|
|
24588
|
+
this.pendingReasons.delete(input.deviceId);
|
|
24227
24589
|
this.pipelineWatchdog?.unregister(input.deviceId);
|
|
24228
24590
|
return { success: true };
|
|
24229
24591
|
}
|
|
24230
24592
|
async assignPipeline(input) {
|
|
24231
24593
|
if (!this.ctx) throw new Error("PipelineOrchestrator: assignPipeline called before initialize");
|
|
24594
|
+
const eligible = this.detectionEligibleNodes();
|
|
24595
|
+
if (!eligible.includes(input.agentNodeId)) throw new Error(`Cannot pin camera ${input.deviceId} detection to '${input.agentNodeId}': the node cannot obtain this camera's decoded frames (frame-source nodes: ${eligible.join(", ") || "none"}). Add it to Enabled Decoder Nodes first.`);
|
|
24232
24596
|
await this.ctx.settings?.writeDeviceStore(input.deviceId, { [PREFERRED_AGENT_SETTING]: input.agentNodeId }).catch((err) => {
|
|
24233
24597
|
const msg = errMsg(err);
|
|
24234
24598
|
this.ctx.logger.warn("assignPipeline: failed to persist pin", {
|
|
@@ -24274,11 +24638,17 @@ var PipelineOrchestratorAddon = class PipelineOrchestratorAddon extends BaseAddo
|
|
|
24274
24638
|
const decision = balance({
|
|
24275
24639
|
nodes: await this.collectAgentLoad({ onlyEnabled: true }),
|
|
24276
24640
|
preferredAgent: null,
|
|
24277
|
-
nodeCaps: this.buildNodeCaps()
|
|
24641
|
+
nodeCaps: await this.buildNodeCaps(),
|
|
24642
|
+
eligibleNodes: this.detectionEligibleNodes()
|
|
24278
24643
|
});
|
|
24279
24644
|
if (!decision) this.ctx.logger.warn("unassignPipeline: no runner available, leaving unassigned", { tags: { deviceId: input.deviceId } });
|
|
24280
|
-
else if (decision.kind === "pending")
|
|
24281
|
-
|
|
24645
|
+
else if (decision.kind === "pending") {
|
|
24646
|
+
this.pendingReasons.set(input.deviceId, decision.reason);
|
|
24647
|
+
this.ctx.logger.warn("camera left pending — no eligible node", {
|
|
24648
|
+
tags: { deviceId: input.deviceId },
|
|
24649
|
+
meta: { reason: decision.reason }
|
|
24650
|
+
});
|
|
24651
|
+
} else {
|
|
24282
24652
|
const targetNodeId = decision.agentNodeId;
|
|
24283
24653
|
if (current && current.agentNodeId !== targetNodeId) await this.detachOn(current.agentNodeId, input.deviceId).catch((err) => {
|
|
24284
24654
|
const msg = errMsg(err);
|
|
@@ -24316,7 +24686,7 @@ var PipelineOrchestratorAddon = class PipelineOrchestratorAddon extends BaseAddo
|
|
|
24316
24686
|
async rebalance() {
|
|
24317
24687
|
if (!this.ctx) throw new Error("PipelineOrchestrator: rebalance called before initialize");
|
|
24318
24688
|
const loads = await this.collectAgentLoad({ onlyEnabled: true });
|
|
24319
|
-
const nodeCaps = this.buildNodeCaps();
|
|
24689
|
+
const nodeCaps = await this.buildNodeCaps();
|
|
24320
24690
|
let migrated = 0;
|
|
24321
24691
|
for (const [deviceId, config] of this.cameraConfigs) {
|
|
24322
24692
|
const current = this.assignments.get(deviceId);
|
|
@@ -24324,11 +24694,16 @@ var PipelineOrchestratorAddon = class PipelineOrchestratorAddon extends BaseAddo
|
|
|
24324
24694
|
const decision = balance({
|
|
24325
24695
|
nodes: loads,
|
|
24326
24696
|
preferredAgent: await this.readPreferredAgent(deviceId),
|
|
24327
|
-
nodeCaps
|
|
24697
|
+
nodeCaps,
|
|
24698
|
+
eligibleNodes: this.detectionEligibleNodes()
|
|
24328
24699
|
});
|
|
24329
24700
|
if (!decision) continue;
|
|
24330
24701
|
if (decision.kind === "pending") {
|
|
24331
|
-
this.
|
|
24702
|
+
this.pendingReasons.set(deviceId, decision.reason);
|
|
24703
|
+
this.ctx.logger.warn("camera left pending — no eligible node", {
|
|
24704
|
+
tags: { deviceId },
|
|
24705
|
+
meta: { reason: decision.reason }
|
|
24706
|
+
});
|
|
24332
24707
|
continue;
|
|
24333
24708
|
}
|
|
24334
24709
|
if (current && current.agentNodeId === decision.agentNodeId) continue;
|
|
@@ -24535,6 +24910,37 @@ var PipelineOrchestratorAddon = class PipelineOrchestratorAddon extends BaseAddo
|
|
|
24535
24910
|
return this.enabledNodes.includes(nodeId);
|
|
24536
24911
|
}
|
|
24537
24912
|
/**
|
|
24913
|
+
* The set of nodes that can OBTAIN a camera's decoded frames.
|
|
24914
|
+
*
|
|
24915
|
+
* **Phase 1 (today):** detection HARD-requires that the runner is itself a
|
|
24916
|
+
* decoder node — a node can only run detection where it can read the shm
|
|
24917
|
+
* frame ring locally. So the frame-source set is exactly
|
|
24918
|
+
* `enabledDecoderNodes`.
|
|
24919
|
+
*
|
|
24920
|
+
* **Phase 2 (T10):** this becomes per-camera source/decoder ownership — a
|
|
24921
|
+
* detection node will be able to source a camera's frames from a co-located
|
|
24922
|
+
* OR a remote restream/decoder leg. Replace this body then; every predicate
|
|
24923
|
+
* change edits this ONE method (and `detectionEligibleNodes`).
|
|
24924
|
+
*/
|
|
24925
|
+
frameSourceNodes() {
|
|
24926
|
+
return this.enabledDecoderNodes;
|
|
24927
|
+
}
|
|
24928
|
+
/**
|
|
24929
|
+
* Nodes eligible to run a camera's detection pipeline: the whitelist of
|
|
24930
|
+
* detection-enabled nodes (`enabledNodes`) intersected with the nodes that
|
|
24931
|
+
* can obtain the camera's frames (`frameSourceNodes()`). A node that is
|
|
24932
|
+
* detection-enabled but cannot source frames (or vice-versa) is NEVER a
|
|
24933
|
+
* valid placement — the balancer receives this as `eligibleNodes` and treats
|
|
24934
|
+
* anything outside it as unassignable (`no-frame-source`).
|
|
24935
|
+
*
|
|
24936
|
+
* Single choke point for T2/T10: passed to every `balance()` call site and
|
|
24937
|
+
* enforced by `assignPipeline` before persisting a pin.
|
|
24938
|
+
*/
|
|
24939
|
+
detectionEligibleNodes() {
|
|
24940
|
+
const frameSource = this.frameSourceNodes();
|
|
24941
|
+
return this.enabledNodes.filter((nodeId) => frameSource.includes(nodeId));
|
|
24942
|
+
}
|
|
24943
|
+
/**
|
|
24538
24944
|
* Query every online runner in the cluster for its current load, plus the
|
|
24539
24945
|
* local runner if co-located. Refreshes the `cachedAgentLoad` snapshot so
|
|
24540
24946
|
* `getAgentLoad()` / `getGlobalMetrics()` can return fresh data.
|
|
@@ -24635,8 +25041,8 @@ var PipelineOrchestratorAddon = class PipelineOrchestratorAddon extends BaseAddo
|
|
|
24635
25041
|
* Used by every `balance()` call so the balancer can honour operator-set
|
|
24636
25042
|
* per-node maximums without polling the store on each decision.
|
|
24637
25043
|
*/
|
|
24638
|
-
buildNodeCaps() {
|
|
24639
|
-
const blob = this.agentSettingsState.get();
|
|
25044
|
+
async buildNodeCaps() {
|
|
25045
|
+
const blob = await this.agentSettingsState.get();
|
|
24640
25046
|
const caps = {};
|
|
24641
25047
|
for (const [nodeId, settings] of Object.entries(blob)) caps[nodeId] = settings.maxCameras ?? null;
|
|
24642
25048
|
return caps;
|
|
@@ -24700,6 +25106,7 @@ var PipelineOrchestratorAddon = class PipelineOrchestratorAddon extends BaseAddo
|
|
|
24700
25106
|
assignedAt: Date.now()
|
|
24701
25107
|
};
|
|
24702
25108
|
this.assignments.set(deviceId, assignment);
|
|
25109
|
+
this.pendingReasons.delete(deviceId);
|
|
24703
25110
|
if (!this.ctx?.eventBus) return;
|
|
24704
25111
|
const payload = {
|
|
24705
25112
|
deviceId,
|
|
@@ -24784,7 +25191,8 @@ var PipelineOrchestratorAddon = class PipelineOrchestratorAddon extends BaseAddo
|
|
|
24784
25191
|
const decision = balance({
|
|
24785
25192
|
nodes: loads,
|
|
24786
25193
|
preferredAgent: null,
|
|
24787
|
-
nodeCaps: this.buildNodeCaps()
|
|
25194
|
+
nodeCaps: await this.buildNodeCaps(),
|
|
25195
|
+
eligibleNodes: this.detectionEligibleNodes()
|
|
24788
25196
|
});
|
|
24789
25197
|
if (!decision) {
|
|
24790
25198
|
this.ctx.logger.error("Failover: no online runner", { tags: { deviceId } });
|
|
@@ -24792,7 +25200,11 @@ var PipelineOrchestratorAddon = class PipelineOrchestratorAddon extends BaseAddo
|
|
|
24792
25200
|
continue;
|
|
24793
25201
|
}
|
|
24794
25202
|
if (decision.kind === "pending") {
|
|
24795
|
-
this.
|
|
25203
|
+
this.pendingReasons.set(deviceId, decision.reason);
|
|
25204
|
+
this.ctx.logger.warn("Failover: camera left pending — no eligible node", {
|
|
25205
|
+
tags: { deviceId },
|
|
25206
|
+
meta: { reason: decision.reason }
|
|
25207
|
+
});
|
|
24796
25208
|
this.assignments.delete(deviceId);
|
|
24797
25209
|
continue;
|
|
24798
25210
|
}
|
|
@@ -24831,6 +25243,7 @@ var PipelineOrchestratorAddon = class PipelineOrchestratorAddon extends BaseAddo
|
|
|
24831
25243
|
tags: { nodeId },
|
|
24832
25244
|
meta: { policy: this.failoverPolicy.onReconnect }
|
|
24833
25245
|
});
|
|
25246
|
+
this.schedulePendingRetry();
|
|
24834
25247
|
if (this.failoverPolicy.onReconnect === "rebalance") {
|
|
24835
25248
|
await this.rebalance().catch((err) => {
|
|
24836
25249
|
const msg = errMsg(err);
|
|
@@ -24838,6 +25251,17 @@ var PipelineOrchestratorAddon = class PipelineOrchestratorAddon extends BaseAddo
|
|
|
24838
25251
|
});
|
|
24839
25252
|
return;
|
|
24840
25253
|
}
|
|
25254
|
+
if (!this.detectionEligibleNodes().includes(nodeId)) {
|
|
25255
|
+
this.ctx.logger.warn("restore skipped — node not frame-source eligible", {
|
|
25256
|
+
tags: { nodeId },
|
|
25257
|
+
meta: { eligibleNodes: this.detectionEligibleNodes().join(",") }
|
|
25258
|
+
});
|
|
25259
|
+
for (const [deviceId, assignment] of this.assignments) {
|
|
25260
|
+
if (assignment.agentNodeId !== nodeId) continue;
|
|
25261
|
+
this.pendingReasons.set(deviceId, "no-frame-source");
|
|
25262
|
+
}
|
|
25263
|
+
return;
|
|
25264
|
+
}
|
|
24841
25265
|
let restored = 0;
|
|
24842
25266
|
for (const [deviceId, config] of this.cameraConfigs) {
|
|
24843
25267
|
const current = this.assignments.get(deviceId);
|
|
@@ -24925,34 +25349,43 @@ var PipelineOrchestratorAddon = class PipelineOrchestratorAddon extends BaseAddo
|
|
|
24925
25349
|
async reattachAudioForNode(nodeId) {
|
|
24926
25350
|
for (const [deviceId, audioNode] of this.audioNodeByDevice) {
|
|
24927
25351
|
if (audioNode !== nodeId) continue;
|
|
24928
|
-
|
|
24929
|
-
|
|
24930
|
-
|
|
24931
|
-
|
|
24932
|
-
|
|
24933
|
-
|
|
24934
|
-
|
|
24935
|
-
|
|
24936
|
-
|
|
24937
|
-
|
|
24938
|
-
|
|
24939
|
-
|
|
24940
|
-
|
|
24941
|
-
|
|
24942
|
-
|
|
24943
|
-
|
|
24944
|
-
|
|
24945
|
-
|
|
24946
|
-
|
|
24947
|
-
|
|
24948
|
-
|
|
24949
|
-
|
|
24950
|
-
|
|
24951
|
-
|
|
24952
|
-
|
|
24953
|
-
|
|
24954
|
-
|
|
24955
|
-
|
|
25352
|
+
await this.reattachAudioForDevice(deviceId);
|
|
25353
|
+
}
|
|
25354
|
+
}
|
|
25355
|
+
/**
|
|
25356
|
+
* Re-establish the audio subscription for ONE camera: tear down any prior
|
|
25357
|
+
* sub and re-subscribe under the current pin/balance, keeping the new handle
|
|
25358
|
+
* only while detection is active. The whole get→teardown→subscribe→store
|
|
25359
|
+
* sequence runs inside `withAudioSubLock` so a prior handle is never orphaned
|
|
25360
|
+
* (the same invariant `reattachAudioForNode` relied on before it was
|
|
25361
|
+
* extracted here). No-op when the device has no runner config or audio is
|
|
25362
|
+
* disabled/lazy (`subscribeAudioStream` self-gates).
|
|
25363
|
+
*/
|
|
25364
|
+
async reattachAudioForDevice(deviceId) {
|
|
25365
|
+
const config = this.cameraConfigs.get(deviceId);
|
|
25366
|
+
if (!config) return;
|
|
25367
|
+
const audioCfg = {
|
|
25368
|
+
...config,
|
|
25369
|
+
enabled: config.pipelineEnabled
|
|
25370
|
+
};
|
|
25371
|
+
try {
|
|
25372
|
+
await this.withAudioSubLock(deviceId, async () => {
|
|
25373
|
+
const prior = this.audioSubscriptions.get(deviceId);
|
|
25374
|
+
if (prior) {
|
|
25375
|
+
try {
|
|
25376
|
+
prior();
|
|
25377
|
+
} catch {}
|
|
25378
|
+
this.audioSubscriptions.delete(deviceId);
|
|
25379
|
+
}
|
|
25380
|
+
const unsub = await this.subscribeAudioStream(deviceId, audioCfg);
|
|
25381
|
+
if (unsub) if (this.activeDetections.has(deviceId)) this.storeAudioSub(deviceId, unsub);
|
|
25382
|
+
else unsub();
|
|
25383
|
+
});
|
|
25384
|
+
} catch (err) {
|
|
25385
|
+
this.ctx.logger.error("audio re-attach failed", {
|
|
25386
|
+
tags: { deviceId },
|
|
25387
|
+
meta: { error: errMsg(err) }
|
|
25388
|
+
});
|
|
24956
25389
|
}
|
|
24957
25390
|
}
|
|
24958
25391
|
/**
|
|
@@ -25027,6 +25460,7 @@ var PipelineOrchestratorAddon = class PipelineOrchestratorAddon extends BaseAddo
|
|
|
25027
25460
|
});
|
|
25028
25461
|
}, 3e3);
|
|
25029
25462
|
this.scheduleReconcile();
|
|
25463
|
+
this.schedulePendingRetry();
|
|
25030
25464
|
} catch (err) {
|
|
25031
25465
|
this.ctx.logger.debug("readiness seed+redispatch failed", {
|
|
25032
25466
|
tags: { nodeId },
|
|
@@ -25141,6 +25575,175 @@ var PipelineOrchestratorAddon = class PipelineOrchestratorAddon extends BaseAddo
|
|
|
25141
25575
|
}
|
|
25142
25576
|
}
|
|
25143
25577
|
}
|
|
25578
|
+
/**
|
|
25579
|
+
* Coalesce bursts of capacity/eligibility/readiness signals into a single
|
|
25580
|
+
* `retryPendingDispatches` pass. Mirrors `scheduleReconcile`, but on a
|
|
25581
|
+
* dedicated (longer) debounce so a raise-cap / node-connect flurry doesn't
|
|
25582
|
+
* hammer `dispatchCamera`.
|
|
25583
|
+
*/
|
|
25584
|
+
schedulePendingRetry() {
|
|
25585
|
+
if (this.pendingRetryDebounceTimer !== null) clearTimeout(this.pendingRetryDebounceTimer);
|
|
25586
|
+
this.pendingRetryDebounceTimer = setTimeout(() => {
|
|
25587
|
+
this.pendingRetryDebounceTimer = null;
|
|
25588
|
+
this.retryPendingDispatches();
|
|
25589
|
+
}, PENDING_RETRY_DEBOUNCE_MS);
|
|
25590
|
+
}
|
|
25591
|
+
/**
|
|
25592
|
+
* Re-dispatch every KNOWN-but-UNASSIGNED camera. `reconcileDispatch` is
|
|
25593
|
+
* additive-only over `cameraConfigs` and never revisits a camera that is
|
|
25594
|
+
* tracked but has no live assignment (left pending by over-cap /
|
|
25595
|
+
* no-frame-source / load-shed), so those cameras would otherwise stay
|
|
25596
|
+
* stranded until an unrelated live event happens to touch them. This sweep
|
|
25597
|
+
* closes that gap.
|
|
25598
|
+
*
|
|
25599
|
+
* `dispatchCamera` re-reads pins, re-balances with the frame-source
|
|
25600
|
+
* predicate, and re-returns pending harmlessly when nothing changed —
|
|
25601
|
+
* so a no-op sweep is cheap and side-effect-free. Serialized with an
|
|
25602
|
+
* in-flight flag + trailing-rerun bit (mirrors `reconcileDispatch`).
|
|
25603
|
+
*/
|
|
25604
|
+
async retryPendingDispatches() {
|
|
25605
|
+
if (this.pendingRetryInFlight) {
|
|
25606
|
+
this.pendingRetryRerunRequested = true;
|
|
25607
|
+
return;
|
|
25608
|
+
}
|
|
25609
|
+
if (this.reconcileInFlight) return;
|
|
25610
|
+
if (!this.api) return;
|
|
25611
|
+
this.pendingRetryInFlight = true;
|
|
25612
|
+
try {
|
|
25613
|
+
const stranded = computeStrandedDevices(new Set(this.cameraConfigs.keys()), new Set(this.assignments.keys()));
|
|
25614
|
+
if (stranded.length > 0) {
|
|
25615
|
+
const loadShedActive = this.isAnyNodeLoadShed();
|
|
25616
|
+
let retried = 0;
|
|
25617
|
+
let stillPending = 0;
|
|
25618
|
+
for (const deviceId of stranded) {
|
|
25619
|
+
if (this.pendingReasons.get(deviceId) === "load-shed" && loadShedActive) {
|
|
25620
|
+
stillPending++;
|
|
25621
|
+
continue;
|
|
25622
|
+
}
|
|
25623
|
+
const cfg = this.cameraConfigs.get(deviceId);
|
|
25624
|
+
if (!cfg) continue;
|
|
25625
|
+
try {
|
|
25626
|
+
const result = await this.dispatchCamera(cfg);
|
|
25627
|
+
retried++;
|
|
25628
|
+
if (result.kind === "pending") stillPending++;
|
|
25629
|
+
} catch (err) {
|
|
25630
|
+
this.ctx.logger.warn("pending retry: dispatchCamera failed", {
|
|
25631
|
+
tags: { deviceId },
|
|
25632
|
+
meta: { error: errMsg(err) }
|
|
25633
|
+
});
|
|
25634
|
+
stillPending++;
|
|
25635
|
+
}
|
|
25636
|
+
}
|
|
25637
|
+
this.ctx.logger.info("pending retry sweep", { meta: {
|
|
25638
|
+
stranded: stranded.length,
|
|
25639
|
+
retried,
|
|
25640
|
+
stillPending
|
|
25641
|
+
} });
|
|
25642
|
+
}
|
|
25643
|
+
await this.evaluateRemoteAssignmentHealth();
|
|
25644
|
+
} finally {
|
|
25645
|
+
this.pendingRetryInFlight = false;
|
|
25646
|
+
if (this.pendingRetryRerunRequested) {
|
|
25647
|
+
this.pendingRetryRerunRequested = false;
|
|
25648
|
+
this.schedulePendingRetry();
|
|
25649
|
+
}
|
|
25650
|
+
}
|
|
25651
|
+
}
|
|
25652
|
+
/** True when any node is currently load-shed paused (used to skip churny retries). */
|
|
25653
|
+
isAnyNodeLoadShed() {
|
|
25654
|
+
for (const state of this.loadShedState.values()) if (state.pausedAt !== null) return true;
|
|
25655
|
+
return false;
|
|
25656
|
+
}
|
|
25657
|
+
/**
|
|
25658
|
+
* Evaluate the health of every REMOTE pipeline assignment and act on the
|
|
25659
|
+
* cameras the pure `evaluateRemoteHealth` flags. The hub watchdog covers
|
|
25660
|
+
* local cameras; this is its remote-node equivalent (gap i). Called from the
|
|
25661
|
+
* T3 sweep tick after retrying pending dispatches.
|
|
25662
|
+
*
|
|
25663
|
+
* `protected` so the remote-health orchestrator spec can drive one evaluation
|
|
25664
|
+
* pass deterministically (mirrors the `pendingReasons`/`audioSubLocks` test-seam
|
|
25665
|
+
* convention in this class) without waiting on the periodic timer.
|
|
25666
|
+
*/
|
|
25667
|
+
async evaluateRemoteAssignmentHealth() {
|
|
25668
|
+
if (!this.api) return;
|
|
25669
|
+
const actions = evaluateRemoteHealth({
|
|
25670
|
+
assignments: this.assignments,
|
|
25671
|
+
fpsMap: this.cameraFpsMap,
|
|
25672
|
+
activeDeviceIds: new Set(this.activeDetections.keys()),
|
|
25673
|
+
localNodeId: this.localNodeId,
|
|
25674
|
+
now: Date.now(),
|
|
25675
|
+
opts: DEFAULT_REMOTE_HEALTH_OPTS
|
|
25676
|
+
});
|
|
25677
|
+
for (const action of actions) await this.handleRemoteHealthReplace(action);
|
|
25678
|
+
}
|
|
25679
|
+
/**
|
|
25680
|
+
* Re-place a single unhealthy remote camera with bounded per-device backoff.
|
|
25681
|
+
* Under budget: detach from the unhealthy node + re-dispatch (inherits the
|
|
25682
|
+
* T2 frame-source predicate). Over budget: log an error, drop the dead
|
|
25683
|
+
* assignment, and mark the camera `'unhealthy'`-pending for the operator so
|
|
25684
|
+
* `getCameraStatus` surfaces it (R2 "bounded-retry ... state visible").
|
|
25685
|
+
*/
|
|
25686
|
+
async handleRemoteHealthReplace(action) {
|
|
25687
|
+
const { deviceId, why } = action;
|
|
25688
|
+
const assignment = this.assignments.get(deviceId);
|
|
25689
|
+
if (!assignment) return;
|
|
25690
|
+
const cfg = this.cameraConfigs.get(deviceId);
|
|
25691
|
+
if (!cfg) return;
|
|
25692
|
+
const now = Date.now();
|
|
25693
|
+
const prior = this.remoteHealthAttempts.get(deviceId);
|
|
25694
|
+
const windowFresh = prior !== void 0 && now - prior.windowStart < REMOTE_HEALTH_WINDOW_MS;
|
|
25695
|
+
const count = windowFresh ? prior.count : 0;
|
|
25696
|
+
if (count >= REMOTE_HEALTH_MAX_ATTEMPTS) {
|
|
25697
|
+
this.ctx.logger.error("remote assignment unhealthy — retries exhausted, leaving pending", {
|
|
25698
|
+
tags: {
|
|
25699
|
+
deviceId,
|
|
25700
|
+
nodeId: assignment.agentNodeId
|
|
25701
|
+
},
|
|
25702
|
+
meta: {
|
|
25703
|
+
why,
|
|
25704
|
+
attempts: count,
|
|
25705
|
+
windowMs: REMOTE_HEALTH_WINDOW_MS
|
|
25706
|
+
}
|
|
25707
|
+
});
|
|
25708
|
+
this.assignments.delete(deviceId);
|
|
25709
|
+
this.pendingReasons.set(deviceId, "unhealthy");
|
|
25710
|
+
await this.detachOn(assignment.agentNodeId, deviceId).catch((err) => {
|
|
25711
|
+
this.ctx.logger.debug("remote-health exhausted-detach failed", {
|
|
25712
|
+
tags: { deviceId },
|
|
25713
|
+
meta: { error: errMsg(err) }
|
|
25714
|
+
});
|
|
25715
|
+
});
|
|
25716
|
+
return;
|
|
25717
|
+
}
|
|
25718
|
+
this.remoteHealthAttempts.set(deviceId, {
|
|
25719
|
+
count: count + 1,
|
|
25720
|
+
windowStart: windowFresh ? prior.windowStart : now
|
|
25721
|
+
});
|
|
25722
|
+
this.ctx.logger.warn("remote assignment unhealthy — re-placing camera", {
|
|
25723
|
+
tags: {
|
|
25724
|
+
deviceId,
|
|
25725
|
+
nodeId: assignment.agentNodeId
|
|
25726
|
+
},
|
|
25727
|
+
meta: {
|
|
25728
|
+
why,
|
|
25729
|
+
attempt: count + 1,
|
|
25730
|
+
maxAttempts: REMOTE_HEALTH_MAX_ATTEMPTS
|
|
25731
|
+
}
|
|
25732
|
+
});
|
|
25733
|
+
await this.detachOn(assignment.agentNodeId, deviceId).catch((err) => {
|
|
25734
|
+
this.ctx.logger.warn("remote-health detach failed", {
|
|
25735
|
+
tags: { deviceId },
|
|
25736
|
+
meta: { error: errMsg(err) }
|
|
25737
|
+
});
|
|
25738
|
+
});
|
|
25739
|
+
this.assignments.delete(deviceId);
|
|
25740
|
+
await this.dispatchCamera(cfg).catch((err) => {
|
|
25741
|
+
this.ctx.logger.warn("remote-health re-dispatch failed", {
|
|
25742
|
+
tags: { deviceId },
|
|
25743
|
+
meta: { error: errMsg(err) }
|
|
25744
|
+
});
|
|
25745
|
+
});
|
|
25746
|
+
}
|
|
25144
25747
|
async getCapabilityBindings(input) {
|
|
25145
25748
|
if (!this.ctx?.settings) return {};
|
|
25146
25749
|
const perNodeRaw = (await this.nodeBindingsState.get().catch(() => ({})))[input.nodeId];
|
|
@@ -25234,12 +25837,17 @@ var PipelineOrchestratorAddon = class PipelineOrchestratorAddon extends BaseAddo
|
|
|
25234
25837
|
}
|
|
25235
25838
|
async assignAudio(input) {
|
|
25236
25839
|
await this.ctx.settings?.writeDeviceStore(input.deviceId, { [AUDIO_NODE_SETTING]: input.nodeId });
|
|
25840
|
+
if (!this.enabledAudioNodes.includes(input.nodeId)) this.ctx.logger.warn("audio pin stored but node is not in enabledAudioNodes — pin will not take effect until enabled", { tags: {
|
|
25841
|
+
deviceId: input.deviceId,
|
|
25842
|
+
nodeId: input.nodeId
|
|
25843
|
+
} });
|
|
25237
25844
|
this.audioAssignments.delete(input.deviceId);
|
|
25238
25845
|
this.audioNodeByDevice.delete(input.deviceId);
|
|
25239
25846
|
this.ctx.logger.info("Audio node pinned", { tags: {
|
|
25240
25847
|
deviceId: input.deviceId,
|
|
25241
25848
|
nodeId: input.nodeId
|
|
25242
25849
|
} });
|
|
25850
|
+
await this.reattachAudioForDevice(input.deviceId);
|
|
25243
25851
|
return { success: true };
|
|
25244
25852
|
}
|
|
25245
25853
|
async unassignAudio(input) {
|
|
@@ -25247,6 +25855,7 @@ var PipelineOrchestratorAddon = class PipelineOrchestratorAddon extends BaseAddo
|
|
|
25247
25855
|
this.audioAssignments.delete(input.deviceId);
|
|
25248
25856
|
this.audioNodeByDevice.delete(input.deviceId);
|
|
25249
25857
|
this.ctx.logger.info("Audio node unpinned", { tags: { deviceId: input.deviceId } });
|
|
25858
|
+
await this.reattachAudioForDevice(input.deviceId);
|
|
25250
25859
|
return { success: true };
|
|
25251
25860
|
}
|
|
25252
25861
|
async getAudioAssignment(input) {
|
|
@@ -25330,6 +25939,7 @@ var PipelineOrchestratorAddon = class PipelineOrchestratorAddon extends BaseAddo
|
|
|
25330
25939
|
tags: { nodeId: input.agentNodeId },
|
|
25331
25940
|
meta: { maxCameras: input.maxCameras }
|
|
25332
25941
|
});
|
|
25942
|
+
this.schedulePendingRetry();
|
|
25333
25943
|
return { success: true };
|
|
25334
25944
|
}
|
|
25335
25945
|
async getCameraSettings(input) {
|
|
@@ -25493,7 +26103,7 @@ var PipelineOrchestratorAddon = class PipelineOrchestratorAddon extends BaseAddo
|
|
|
25493
26103
|
const detectionNodeId = pipelineAssignment?.agentNodeId ?? null;
|
|
25494
26104
|
const decoderPinRaw = (api ? await this.ctx.settings?.readDeviceStore(deviceId).catch(() => ({})) ?? {} : {})["decoderNodeId"];
|
|
25495
26105
|
const decoderPinned = typeof decoderPinRaw === "string" && decoderPinRaw !== "auto";
|
|
25496
|
-
const
|
|
26106
|
+
const advisoryDecoderNodeId = detectionNodeId ? await this.resolveDecoderNode(deviceId, detectionNodeId).catch(() => null) : null;
|
|
25497
26107
|
const audioAssignment = this.audioAssignments.get(deviceId) ?? null;
|
|
25498
26108
|
const audioNodeId = audioAssignment?.nodeId ?? null;
|
|
25499
26109
|
const audioPinned = audioAssignment?.pinned ?? false;
|
|
@@ -25502,11 +26112,8 @@ var PipelineOrchestratorAddon = class PipelineOrchestratorAddon extends BaseAddo
|
|
|
25502
26112
|
decoder: decoderPinned,
|
|
25503
26113
|
audio: audioPinned
|
|
25504
26114
|
};
|
|
25505
|
-
const
|
|
25506
|
-
|
|
25507
|
-
decoder: decoderPinned ? "manual" : "co-located",
|
|
25508
|
-
audio: audioPinned ? "manual" : void 0
|
|
25509
|
-
};
|
|
26115
|
+
const detectionReason = pipelineAssignment !== null ? pipelineAssignment.reason : this.cameraConfigs.has(deviceId) ? `pending:${this.pendingReasons.get(deviceId) ?? "pending"}` : void 0;
|
|
26116
|
+
const liveDecoder = { nodeId: null };
|
|
25510
26117
|
const allSlotsFetch = api ? api.streamBroker.listAllProfileSlots.query() : null;
|
|
25511
26118
|
const sourceFetch = api && allSlotsFetch ? this.boundedStage(allSlotsFetch.then((slots) => {
|
|
25512
26119
|
return { streams: slots.filter((s) => s.deviceId === deviceId).map((s) => ({
|
|
@@ -25537,17 +26144,19 @@ var PipelineOrchestratorAddon = class PipelineOrchestratorAddon extends BaseAddo
|
|
|
25537
26144
|
clients: await api.streamBroker.listClients.query({ brokerId: slot.brokerId }).catch(() => null)
|
|
25538
26145
|
};
|
|
25539
26146
|
})), api.streamBroker.getAllRtspEntries.query({}).catch(() => null)]);
|
|
26147
|
+
const profileDetails = statsAndClients.map(({ slot, stats, clients }) => ({
|
|
26148
|
+
profile: slot.profile,
|
|
26149
|
+
status: slot.status,
|
|
26150
|
+
codec: stats?.codec ?? slot.codec ?? "",
|
|
26151
|
+
width: slot.resolution?.width ?? 0,
|
|
26152
|
+
height: slot.resolution?.height ?? 0,
|
|
26153
|
+
subscribers: clients?.encodedSubscribers ?? 0,
|
|
26154
|
+
inFps: stats?.inputFps ?? 0,
|
|
26155
|
+
outFps: stats?.decodeFps ?? 0
|
|
26156
|
+
}));
|
|
26157
|
+
for (const { stats } of statsAndClients) if (liveDecoder.nodeId === null && typeof stats?.decoderNodeId === "string") liveDecoder.nodeId = stats.decoderNodeId;
|
|
25540
26158
|
return {
|
|
25541
|
-
profiles:
|
|
25542
|
-
profile: slot.profile,
|
|
25543
|
-
status: slot.status,
|
|
25544
|
-
codec: stats?.codec ?? slot.codec ?? "",
|
|
25545
|
-
width: slot.resolution?.width ?? 0,
|
|
25546
|
-
height: slot.resolution?.height ?? 0,
|
|
25547
|
-
subscribers: clients?.encodedSubscribers ?? 0,
|
|
25548
|
-
inFps: stats?.inputFps ?? 0,
|
|
25549
|
-
outFps: stats?.decodeFps ?? 0
|
|
25550
|
-
})),
|
|
26159
|
+
profiles: profileDetails,
|
|
25551
26160
|
webrtcSessions: statsAndClients.reduce((total, { clients }) => {
|
|
25552
26161
|
if (!clients) return total;
|
|
25553
26162
|
return total + clients.encoded.filter((c) => WEBRTC_KINDS.has(c.attribution.kind)).length;
|
|
@@ -25557,8 +26166,8 @@ var PipelineOrchestratorAddon = class PipelineOrchestratorAddon extends BaseAddo
|
|
|
25557
26166
|
}) ?? false
|
|
25558
26167
|
};
|
|
25559
26168
|
}), STAGE_TIMEOUT_MS) : Promise.resolve(null);
|
|
25560
|
-
const decoderFetch =
|
|
25561
|
-
nodeId:
|
|
26169
|
+
const decoderFetch = advisoryDecoderNodeId ? Promise.resolve({
|
|
26170
|
+
nodeId: advisoryDecoderNodeId,
|
|
25562
26171
|
formats: [],
|
|
25563
26172
|
sessionCount: 0,
|
|
25564
26173
|
shm: {
|
|
@@ -25626,6 +26235,13 @@ var PipelineOrchestratorAddon = class PipelineOrchestratorAddon extends BaseAddo
|
|
|
25626
26235
|
detectionFetch,
|
|
25627
26236
|
recordingFetch
|
|
25628
26237
|
]);
|
|
26238
|
+
const liveDecoderNodeId = brokerResult !== null ? liveDecoder.nodeId : null;
|
|
26239
|
+
const decoderNodeId = liveDecoderNodeId ?? advisoryDecoderNodeId;
|
|
26240
|
+
const reasons = {
|
|
26241
|
+
detection: detectionReason,
|
|
26242
|
+
decoder: decoderPinned ? "manual" : liveDecoderNodeId !== null ? "session" : decoderNodeId !== null ? "advisory" : void 0,
|
|
26243
|
+
audio: audioPinned ? "manual" : void 0
|
|
26244
|
+
};
|
|
25629
26245
|
return composeCameraStatus({
|
|
25630
26246
|
deviceId,
|
|
25631
26247
|
fetchedAt: Date.now(),
|
|
@@ -25981,7 +26597,7 @@ var PipelineOrchestratorAddon = class PipelineOrchestratorAddon extends BaseAddo
|
|
|
25981
26597
|
id: "cluster",
|
|
25982
26598
|
title: "Cluster",
|
|
25983
26599
|
tab: "pipeline",
|
|
25984
|
-
description: "Which cluster nodes are eligible to run the detection pipeline.
|
|
26600
|
+
description: "Which cluster nodes are eligible to run the detection pipeline. Strict whitelist: an empty list disables dispatch everywhere. Fresh installs default to ['hub']. Video detection additionally requires the node to be frame-source capable (Enabled Decoder Nodes) until cross-node frame transport ships.",
|
|
25985
26601
|
fields: [
|
|
25986
26602
|
{
|
|
25987
26603
|
key: "enabledNodes",
|
|
@@ -26513,6 +27129,7 @@ var PipelineOrchestratorAddon = class PipelineOrchestratorAddon extends BaseAddo
|
|
|
26513
27129
|
this.enabledDecoderNodes = rawEnabledDecoder === void 0 ? ["hub"] : Array.isArray(rawEnabledDecoder) ? rawEnabledDecoder.filter((v) => typeof v === "string" && !v.includes("/")) : ["hub"];
|
|
26514
27130
|
const rawEnabledAudio = config["enabledAudioNodes"];
|
|
26515
27131
|
this.enabledAudioNodes = rawEnabledAudio === void 0 ? ["hub"] : Array.isArray(rawEnabledAudio) ? rawEnabledAudio.filter((v) => typeof v === "string" && !v.includes("/")) : ["hub"];
|
|
27132
|
+
this.schedulePendingRetry();
|
|
26516
27133
|
}
|
|
26517
27134
|
get api() {
|
|
26518
27135
|
return this.ctx.api ?? null;
|