@camstack/addon-terminal 0.1.31 → 0.1.33

package/dist/addon.js

@@ -5833,6 +5833,13 @@ var BaseAddon = class {
 	_readinessGeneration = typeof crypto !== "undefined" && crypto.randomUUID ? crypto.randomUUID() : Math.random().toString(36).slice(2, 14);
 	/** Capability names this addon registered at init — used to emit matching `down` events on shutdown. */
 	_registeredCapNames = [];
+	/**
+	* True only after `readAddonStore` actually answered. Constructor
+	* defaults look like stored config when the store is down — a forked
+	* addon that auto-starts from those defaults (cloudflare-tunnel quick
+	* mode, 2026-08-25) is not "the operator chose this".
+	*/
+	settingsStoreReady = false;
 	/** Default config values. Provided via constructor. */
 	defaults;
 	constructor(defaults) {
@@ -6233,7 +6240,9 @@ var BaseAddon = class {
 		];
 		let lastErr;
 		for (let attempt = 0; attempt <= delaysMs.length; attempt++) try {
-			return await settings.readAddonStore() ?? {};
+			const stored = await settings.readAddonStore() ?? {};
+			this.settingsStoreReady = true;
+			return stored;
 		} catch (err) {
 			lastErr = err;
 			const msg = err instanceof Error ? err.message : String(err);
@@ -6241,6 +6250,7 @@ var BaseAddon = class {
 			if (attempt === delaysMs.length) break;
 			await new Promise((r) => setTimeout(r, delaysMs[attempt]));
 		}
+		this.settingsStoreReady = false;
 		this._ctx?.logger?.warn?.("readAddonStore: settings-store unavailable after retries — using defaults", { meta: { error: lastErr instanceof Error ? lastErr.message : String(lastErr) } });
 		return {};
 	}
@@ -8119,6 +8129,15 @@ var LabelDefinitionSchema = object({
 	description: string().optional(),
 	icon: string().optional()
 });
+var ClassMapDefinitionSchema = object({
+	mapping: record(string(), _enum([
+		"person",
+		"vehicle",
+		"animal",
+		"package"
+	])),
+	preserveOriginal: boolean()
+});
 var MODEL_FORMATS = [
 	"onnx",
 	"coreml",
@@ -8202,6 +8221,12 @@ var ModelVariantGroupSchema = object({
 	*/
 	resolution: number().int().positive().optional()
 });
+var ModelProviderIdSchema = _enum([
+	"camstack",
+	"frigate",
+	"scrypted",
+	"custom"
+]);
 var ModelCatalogEntrySchema = object({
 	id: string(),
 	name: string(),
@@ -8297,7 +8322,19 @@ var ModelCatalogEntrySchema = object({
 	* `id` stays the source of truth for resolution/download/persistence; grouping
 	* is a presentation overlay resolved back to an `id`.
 	*/
-	group: ModelVariantGroupSchema.optional()
+	group: ModelVariantGroupSchema.optional(),
+	/**
+	* Catalog source for the pipeline stepper's provider-first picker. Absent on
+	* built-in CamStack entries (treated as `camstack`) and on registry rows
+	* persisted before this field existed (`inferModelProvider` fills those).
+	*/
+	provider: ModelProviderIdSchema.optional(),
+	/**
+	* Per-MODEL class map override. Absent ⇒ the step's `StepDefinition.classMap`
+	* applies (Frigate / COCO public catalog). Set on a custom model whose raw
+	* labels already ARE the CamStack macros (Scrypted identity map).
+	*/
+	classMap: ClassMapDefinitionSchema.optional()
 });
 var ConvertTargetSchema = discriminatedUnion("format", [object({
 	format: literal("openvino"),
@@ -8326,7 +8363,8 @@ var ModelConvertMetadataSchema = object({
 		"ocr",
 		"segmentation"
 	]),
-	faceAlignment: boolean().optional()
+	faceAlignment: boolean().optional(),
+	classMap: ClassMapDefinitionSchema.optional()
 });
 var ConvertResultSchema = object({
 	entry: ModelCatalogEntrySchema,
@@ -12028,6 +12066,27 @@ var LinkedDeviceSchema = object({
 	features: array(string()),
 	producesTrackedEvents: boolean().optional()
 });
+/** One camera's resolved linked set, tagged with the camera it belongs to.
+*  The batch answer needs the tag; the single-device answer already has it
+*  from the input, which is why `getLinkedDevices` keeps the untagged shape. */
+var LinkedDevicesForDeviceSchema = object({
+	deviceId: number(),
+	mode: LinkedDevicesModeSchema,
+	devices: array(LinkedDeviceSchema)
+});
+/** One device's binding map — the shape `getBindings`, `getBindingsBatch` and
+*  `getAllBindings` all answer in. Declared once: three copies of the same
+*  object literal is exactly how the three drift apart. */
+var DeviceBindingsForDeviceSchema = object({
+	deviceId: number(),
+	entries: array(object({
+		capName: string(),
+		kind: _enum(["native", "wrapped"]),
+		providerAddonId: string(),
+		providerNodeId: string(),
+		nativeAddonId: string()
+	}))
+});
 var SavedDeviceRowSchema = object({
 	/** Numeric id reserved at allocateDeviceId time. */
 	id: number(),
@@ -12253,11 +12312,25 @@ method(object({
 	projection: _enum(["full", "slim"]).optional(),
 	/** Return only camera devices. Filtering server-side instead of
 	*  shipping 293 rows to find 12. */
-	isCamera: boolean().optional()
+	isCamera: boolean().optional(),
+	/**
+	* Return only these device ids. For the caller that already KNOWS the
+	* handful it wants and needs a field the id-bearing answer does not
+	* carry — the viewer's linked-devices panel joins `type` and `online`
+	* onto ~8 linked ids and, unfiltered, dragged the fleet across to do
+	* it: 433 KB slim / 958 KB full for 967 devices, on a query that
+	* refetches on the reconcile interval, on a phone.
+	*
+	* Safe to send at a hub that predates it: Zod STRIPS unknown input
+	* keys rather than rejecting them (verified against the live hub
+	* 2026-08-25 — 967 rows came back), so an old hub answers exactly what
+	* it answers today and the caller filters as it already does.
+	*/
+	deviceIds: array(number()).optional()
 }), array(DeviceInfoSchema)), method(object({ deviceId: number() }), DeviceInfoSchema.nullable()), method(object({ parentDeviceId: number() }), array(DeviceInfoSchema)), method(object({ deviceId: number() }), object({
 	mode: LinkedDevicesModeSchema,
 	devices: array(LinkedDeviceSchema)
-})), method(object({ deviceId: number() }), array(StreamSourceEntrySchema$1)), method(object({ deviceId: number() }), array(ConfigEntrySchema)), method(object({ deviceId: number() }), ConfigUISchemaOutput), method(object({
+})), method(object({ deviceIds: array(number()) }), array(LinkedDevicesForDeviceSchema)), method(object({ deviceId: number() }), array(StreamSourceEntrySchema$1)), method(object({ deviceId: number() }), array(ConfigEntrySchema)), method(object({ deviceId: number() }), ConfigUISchemaOutput), method(object({
 	deviceId: number(),
 	values: record(string(), unknown())
 }), object({ success: literal(true) }), {
@@ -12284,25 +12357,7 @@ method(object({
 }), method(object({ deviceId: number() }), array(StreamProbeResultSchema), {
 	kind: "mutation",
 	auth: "admin"
-}), method(object({ deviceId: number() }), object({
-	deviceId: number(),
-	entries: array(object({
-		capName: string(),
-		kind: _enum(["native", "wrapped"]),
-		providerAddonId: string(),
-		providerNodeId: string(),
-		nativeAddonId: string()
-	}))
-})), method(object({}), array(object({
-	deviceId: number(),
-	entries: array(object({
-		capName: string(),
-		kind: _enum(["native", "wrapped"]),
-		providerAddonId: string(),
-		providerNodeId: string(),
-		nativeAddonId: string()
-	}))
-}))), method(object({
+}), method(object({ deviceId: number() }), DeviceBindingsForDeviceSchema), method(object({ deviceIds: array(number()) }), array(DeviceBindingsForDeviceSchema)), method(object({}), array(DeviceBindingsForDeviceSchema)), method(object({
 	deviceId: number(),
 	capName: string(),
 	wrapperAddonId: string(),
@@ -14712,12 +14767,15 @@ var NcOccupancyConditionSchema = object({
 * there is no second switch that can disagree with the first and every rule
 * authored before the decision migrates for free (`audioModeOf`):
 *
-*  - **LABEL mode — `labels` present.** The rule fires on the FIRST frame the
-*    classifier labels with one of them. No window, no percentage:
-*    `hitPercent` and `samplingSeconds` are ignored, and the rule's own
-*    `throttle` cooldown is the only brake. The per-label confidence floor is
-*    the analyzer's (`classificationMinScore`, per device) — a label only
-*    reaches this condition if the classifier was already confident enough.
+*  - **LABEL mode — `labels` present.** The rule fires when `confirmHits`
+*    labelled frames land inside `confirmWindowSec` (default 2 in 5 s).
+*    `hitPercent` and `samplingSeconds` are still ignored — a percentage of
+*    frames is the wrong question for a classifier that labels 1–3 frames
+*    per episode. The count window is the brake that drops a single-frame
+*    false positive; the rule's own `throttle` cooldown is the other. The
+*    per-label confidence floor is the analyzer's (`classificationMinScore`,
+*    per device) — a label only reaches this condition if the classifier was
+*    already confident enough. `confirmHits: 1` restores first-frame fire.
 *  - **LEVEL mode — `dbThreshold` present, no labels.** The sampling window IS
 *    the condition: at least `hitPercent`% of the samples over
 *    `samplingSeconds` must be at or above `dbThreshold` dBFS (see
@@ -14744,14 +14802,22 @@ var NcOccupancyConditionSchema = object({
 * an operator who typed `dog` mean the same thing.
 */
 var NcAudioConditionSchema = object({
-	/** LABEL MODE: audio macro labels. Present ⇒ fires on the first labelled frame. */
+	/** LABEL MODE: audio macro labels. Present ⇒ count-in-window confirm. */
 	labels: array(string().min(1)).min(1).optional(),
 	/** LEVEL MODE: floor in dBFS (negative-going, `0` = full scale). */
 	dbThreshold: number().min(-96).max(0).optional(),
 	/** LEVEL MODE ONLY: percentage of the window's samples that must be hits (1–100). */
 	hitPercent: number().int().min(1).max(100).default(60),
 	/** LEVEL MODE ONLY: length of the sampling window in seconds. */
-	samplingSeconds: number().int().min(1).max(300).default(10)
+	samplingSeconds: number().int().min(1).max(300).default(10),
+	/**
+	* LABEL MODE: how many labelled frames must land inside
+	* {@link NcAudioConditionSchema.shape.confirmWindowSec} before dispatch.
+	* Absent ⇒ 2 (the matcher default). `1` is first-frame fire.
+	*/
+	confirmHits: number().int().min(1).max(20).optional(),
+	/** LABEL MODE: the window those frames must share, in seconds. Absent ⇒ 5. */
+	confirmWindowSec: number().int().min(1).max(60).optional()
 });
 /**
 * Which zone-crossing DIRECTION a rule accepts (`ObjectEvent.zoneCrossing`).
@@ -17125,6 +17191,46 @@ var RecentTracksPageSchema = object({
 	/** Cursor for the next page, or null when this page is the last. */
 	nextCursor: string().nullable()
 });
+var LIST_GROUPS_DEFAULT_LIMIT = 40;
+var LIST_GROUPS_MAX_LIMIT = 100;
+var AnalyticsGroupRecordSchema = object({
+	id: string(),
+	deviceId: number().int(),
+	openedAt: number().int(),
+	closedAt: number().int(),
+	timestamp: number().int(),
+	memberCount: number().int(),
+	memberTrackIds: array(string()).readonly(),
+	className: string(),
+	classes: array(string()).readonly(),
+	/** Relative event-media path, or null when the group has no picture yet. */
+	mediaUrl: string().nullable(),
+	singleton: boolean()
+});
+var AnalyticsGroupMemberSchema = object({
+	trackId: string(),
+	deviceId: number().int(),
+	className: string(),
+	firstSeen: number().int(),
+	lastSeen: number().int(),
+	mediaUrl: string().nullable()
+});
+var AnalyticsGroupDetailSchema = AnalyticsGroupRecordSchema.extend({ members: array(AnalyticsGroupMemberSchema).readonly() });
+var ListGroupsQueryInput = object({
+	/** Devices to merge. An empty array yields `{ groups: [], nextCursor: null }`. */
+	deviceIds: array(number()),
+	/** Window lower bound on `closedAt` (inclusive). */
+	since: number().optional(),
+	/** Window upper bound on `openedAt` (inclusive). */
+	until: number().optional(),
+	limit: number().int().min(1).max(LIST_GROUPS_MAX_LIMIT).default(LIST_GROUPS_DEFAULT_LIMIT),
+	/** Opaque continuation cursor from a previous page's `nextCursor`. */
+	cursor: string().optional()
+});
+var ListGroupsPageSchema = object({
+	groups: array(AnalyticsGroupRecordSchema).readonly(),
+	nextCursor: string().nullable()
+});
 var KeyEventQueryInput = object({
 	deviceId: number(),
 	/** Window lower bound (track firstSeen ≥ since). */
@@ -17200,7 +17306,9 @@ var TrackCascadeCountsSchema = object({
 	/** Unassigned plate reads removed (best-effort; plate leg deferred to plate-intelligence). */
 	plates: number().int(),
 	/** Per-track CLIP search vectors removed (best-effort). */
-	embeddings: number().int()
+	embeddings: number().int(),
+	/** Group membership + group rows removed with their last member (best-effort). */
+	groups: number().int()
 });
 /** Disk-wins reconcile: media rows whose blobs are gone, then empty tracks. */
 var DiskReconcileCountsSchema = object({
@@ -17346,7 +17454,10 @@ DeviceType.Camera, method(object({ deviceId: number() }), array(TrackSchema).rea
 	*  stationary registry). Default false: the timeline lists passages,
 	*  not parking records (operator decision, 2026-08-15). */
 	includeStationary: boolean().optional()
-}), array(TrackSchema).readonly()), method(RecentTracksQueryInput, RecentTracksPageSchema), method(object({ deviceId: number() }), _void(), {
+}), array(TrackSchema).readonly()), method(RecentTracksQueryInput, RecentTracksPageSchema), method(ListGroupsQueryInput, ListGroupsPageSchema), method(object({
+	deviceId: number(),
+	groupId: string().min(1)
+}), AnalyticsGroupDetailSchema.nullable()), method(object({ deviceId: number() }), _void(), {
 	kind: "mutation",
 	auth: "admin"
 }), method(DeviceEventQueryInput, array(MotionEventSchema).readonly()), method(ObjectEventQueryInput, array(ObjectEventSchema).readonly()), method(DeviceEventQueryInput, array(AudioEventSchema).readonly()), method(object({ deviceId: number() }), array(EventKindDescriptorSchema).readonly()), method(object({ deviceIds: array(number()).min(1).max(200) }), array(EventKindsForDeviceSchema).readonly()), method(object({
@@ -17564,6 +17675,33 @@ var NativeCropRefSchema = object({
 		h: number()
 	})
 });
+object({
+	crop: object({
+		left: number(),
+		top: number(),
+		width: number().positive(),
+		height: number().positive()
+	}).optional(),
+	content: object({
+		width: number().int().positive(),
+		height: number().int().positive()
+	}),
+	fit: _enum(["stretch", "contain"]),
+	format: _enum([
+		"rgb",
+		"gray",
+		"jpeg"
+	])
+});
+var FrameRefSchema = object({
+	registryId: string().min(1),
+	id: string().min(1),
+	width: number().int().positive(),
+	height: number().int().positive(),
+	format: _enum(["rgb", "gray"]),
+	timestamp: number(),
+	capturedAt: number().optional()
+});
 var ModelFormatSchema$1 = _enum([
 	"onnx",
 	"coreml",
@@ -17629,7 +17767,8 @@ var PipelineModelOptionSchema = object({
 		sizeMB: number()
 	})),
 	group: ModelVariantGroupSchema.optional(),
-	legacy: boolean().optional()
+	legacy: boolean().optional(),
+	provider: ModelProviderIdSchema.optional()
 });
 var ConfigFieldBridge = custom();
 var PipelineAddonSchemaSchema = object({
@@ -17808,6 +17947,12 @@ method(_void(), array(PipelineEngineChoiceSchema)), method(_void(), PipelineEngi
 	steps: array(PipelineStepInputSchema).min(1),
 	frame: FrameInputSchema.optional(),
 	/**
+	* Process-local lazy frame. Valid only when caller and provider resolve
+	* in the same execution-group process; split/cross-node callers use
+	* `frame`/`image` inline compatibility instead.
+	*/
+	frameRef: FrameRefSchema.optional(),
+	/**
 	* CB5 shm passthrough — a `FrameHandle` naming the same ring slot
 	* the decoded pixels live in. One more member of the one-of
 	* frame/frameHandle/image/imageBase64/referenceImage group.
@@ -18103,7 +18248,10 @@ var NativeCropResultSchema = object({
 	* Which source served this crop, so a quality-sensitive consumer (the native
 	* `keyFrame`) can reject a degraded fallback:
 	* - `native` — cut from the decode worker's retained NATIVE surface (the
-	*   quality path).
+	*   quality path). A subject-tile serve is also native-resolution and stays
+	*   `native` here: the public enum cannot name `tile` without a breaking cap
+	*   change. Runner telemetry distinguishes lease vs tile via `source` on the
+	*   internal crop result (`nativeHits` vs `tileHits`).
 	* - `ram-fullframe` — the native surface MISSED but the request was full-frame,
 	*   so the ≤640 RAM `RetainedFrameStore` served it (honest lower-res; legit for
 	*   the blank-frame guard / 640-snapshot resolve, NOT for the clean keyFrame).
@@ -18594,12 +18742,41 @@ var RunnerLocalLoadSchema = object({
 * legacy `OrchestratorMetricsSchema` shape so existing dashboards keep
 * working unchanged when they switch to reading from the runner cap.
 */
+var FrameLazyCountersSchema = object({
+	framesDecoded: number(),
+	framesAdmitted: number(),
+	framesDroppedPixelFree: number(),
+	viewsMaterialized: number(),
+	viewsSkipped: number(),
+	workerToRunnerBytes: number(),
+	runnerToPoolRawBytes: number(),
+	runnerToPoolJpegBytes: number(),
+	onDemandFullFrameRequests: number(),
+	onDemandCropRequests: number(),
+	nativeHits: number(),
+	nativeMisses: number(),
+	tileHits: number(),
+	tileMisses: number(),
+	fallbackHits: number(),
+	fallbackMisses: number(),
+	retainedWritesAvoided: number(),
+	residentRefs: number(),
+	residentBytes: number(),
+	releases: number(),
+	evictions: number(),
+	staleMisses: number()
+});
+var FrameLazyMetricsSchema = object({
+	node: FrameLazyCountersSchema,
+	cameras: array(FrameLazyCountersSchema.extend({ deviceId: number() }))
+});
 var RunnerLocalMetricsSchema = object({
 	nodeId: string(),
 	activeCameras: number(),
 	throttledCameras: number(),
 	avgInferenceTimeMs: number(),
-	queueDepth: number()
+	queueDepth: number(),
+	frameLazy: FrameLazyMetricsSchema.optional()
 });
 method(RunnerCameraConfigSchema, object({ success: literal(true) }), { kind: "mutation" }), method(object({ deviceId: number() }), object({ success: literal(true) }), { kind: "mutation" }), method(ReportMotionInputSchema, object({ success: literal(true) }), { kind: "mutation" }), method(_void(), RunnerLocalLoadSchema), method(_void(), RunnerLocalMetricsSchema), method(object({ deviceId: number() }), CameraMetricsSchema.nullable()), method(_void(), array(CameraMetricsWithDeviceIdSchema).readonly()), method(_void(), array(number()).readonly()), method(object({
 	handle: FrameHandleSchema,
@@ -24209,6 +24386,17 @@ var NotificationEndpointSchema = object({
 	/** What the ranking currently resolves to (null when nothing is reachable). */
 	resolved: string().nullable()
 });
+/**
+* The URLs the SDK / viewer should race for API access. `baseUrls` empty =
+* AUTO (every LAN IPv4 + the public tunnel). `resolved` is what that choice
+* currently expands to, so the UI can show the effective set either way.
+*/
+var ViewerEndpointsSchema = object({
+	/** The operator's explicit race set, or empty for AUTO. */
+	baseUrls: array(string()).readonly(),
+	/** What the ranking currently resolves to (may be empty if nothing is up). */
+	resolved: array(string()).readonly()
+});
 var AllowedAddressesSchema = object({ 
 /**
 * Allowlist of interface addresses operators have explicitly opted
@@ -24240,17 +24428,18 @@ method(_void(), ListResultSchema), method(_void(), PreferredSchema), method(obje
 	*/
 	port: number().int().min(1).max(65535).optional(),
 	/** Include `http(s)://127.0.0.1:<port>` as the lowest-priority
-	*  candidate. Default `true`. */
+	*  candidate. Default `false` — loopback is not a client route. */
 	includeLoopback: boolean().optional(),
-	/** Skip IPv6 entries. Some legacy clients can't parse them.
-	*  Default `false`. */
+	/** Skip IPv6 entries. Default `false` — the palette includes stable
+	*  LAN IPv6 (ICE/WebRTC uses dual-stack regardless). Pass `true` to
+	*  hide them. The viewer HTTP/WS race is `getViewerEndpoints`. */
 	ipv4Only: boolean().optional(),
 	/** Scheme to emit for LAN/loopback URLs. Default `'http'`.
 	*  Pass `'https'` when the caller is itself loaded over HTTPS
 	*  to avoid mixed-content blocks in the browser. The public
 	*  tunnel always emits `https://` regardless. */
 	scheme: _enum(["http", "https"]).optional()
-}), GetConnectionEndpointsResultSchema), method(_void(), NotificationEndpointSchema), method(object({ baseUrl: string().nullable() }), NotificationEndpointSchema, { kind: "mutation" }), method(_void(), AllowedAddressesSchema), method(AllowedAddressesSchema, object({ success: literal(true) }), { kind: "mutation" }), method(_void(), AllowedAddressesSchema, { kind: "mutation" }), method(_void(), TlsStatusSchema), method(object({ reason: string().optional() }), TlsStatusSchema, {
+}), GetConnectionEndpointsResultSchema), method(_void(), NotificationEndpointSchema), method(object({ baseUrl: string().nullable() }), NotificationEndpointSchema, { kind: "mutation" }), method(_void(), ViewerEndpointsSchema), method(object({ baseUrls: array(string()).readonly() }), ViewerEndpointsSchema, { kind: "mutation" }), method(_void(), AllowedAddressesSchema), method(AllowedAddressesSchema, object({ success: literal(true) }), { kind: "mutation" }), method(_void(), AllowedAddressesSchema, { kind: "mutation" }), method(_void(), TlsStatusSchema), method(object({ reason: string().optional() }), TlsStatusSchema, {
 	kind: "mutation",
 	auth: "admin"
 }), method(object({
@@ -25824,7 +26013,12 @@ var PlateInfoSchema = object({
 	plateBbox: BoundingBoxSchema.optional(),
 	/** keyFrame parity: MediaStore key of the track's native-resolution key frame. */
 	keyFrameMediaKey: string().optional(),
-	base64: string().optional()
+	base64: string().optional(),
+	/**
+	* Same crop as a data-plane URL. `getPlateByTrack` returns this and
+	* never inlines JPEG; `listPlates` still inlines for the admin-ui.
+	*/
+	cropUrl: string().optional()
 });
 var MediaFileLiteSchema = object({
 	key: string(),
@@ -31346,6 +31540,12 @@ Object.freeze({
 		addonId: null,
 		access: "view"
 	},
+	"deviceManager.getBindingsBatch": {
+		capName: "device-manager",
+		capScope: "system",
+		addonId: null,
+		access: "view"
+	},
 	"deviceManager.getChildren": {
 		capName: "device-manager",
 		capScope: "system",
@@ -31406,6 +31606,12 @@ Object.freeze({
 		addonId: null,
 		access: "view"
 	},
+	"deviceManager.getLinkedDevicesBatch": {
+		capName: "device-manager",
+		capScope: "system",
+		addonId: null,
+		access: "view"
+	},
 	"deviceManager.getRoleDisplayDefaults": {
 		capName: "device-manager",
 		capScope: "system",
@@ -32324,6 +32530,12 @@ Object.freeze({
 		addonId: null,
 		access: "view"
 	},
+	"localNetwork.getViewerEndpoints": {
+		capName: "local-network",
+		capScope: "system",
+		addonId: null,
+		access: "view"
+	},
 	"localNetwork.list": {
 		capName: "local-network",
 		capScope: "system",
@@ -32360,6 +32572,12 @@ Object.freeze({
 		addonId: null,
 		access: "create"
 	},
+	"localNetwork.setViewerEndpoints": {
+		capName: "local-network",
+		capScope: "system",
+		addonId: null,
+		access: "create"
+	},
 	"localNetwork.uploadCertificate": {
 		capName: "local-network",
 		capScope: "system",
@@ -33164,6 +33382,12 @@ Object.freeze({
 		addonId: null,
 		access: "view"
 	},
+	"pipelineAnalytics.getGroup": {
+		capName: "pipeline-analytics",
+		capScope: "device",
+		addonId: null,
+		access: "view"
+	},
 	"pipelineAnalytics.getKeyEvents": {
 		capName: "pipeline-analytics",
 		capScope: "device",
@@ -33248,6 +33472,12 @@ Object.freeze({
 		addonId: null,
 		access: "view"
 	},
+	"pipelineAnalytics.listGroups": {
+		capName: "pipeline-analytics",
+		capScope: "device",
+		addonId: null,
+		access: "view"
+	},
 	"pipelineAnalytics.listOpsLog": {
 		capName: "pipeline-analytics",
 		capScope: "device",
@@ -36029,6 +36259,11 @@ Object.freeze({
 		form: "single",
 		optional: false
 	}],
+	"deviceManager.getBindingsBatch": [{
+		name: "deviceIds",
+		form: "array",
+		optional: false
+	}],
 	"deviceManager.getChildren": [{
 		name: "parentDeviceId",
 		form: "single",
@@ -36074,6 +36309,11 @@ Object.freeze({
 		form: "single",
 		optional: false
 	}],
+	"deviceManager.getLinkedDevicesBatch": [{
+		name: "deviceIds",
+		form: "array",
+		optional: false
+	}],
 	"deviceManager.getSettingsSchema": [{
 		name: "deviceId",
 		form: "single",
@@ -36094,6 +36334,11 @@ Object.freeze({
 		form: "single",
 		optional: false
 	}],
+	"deviceManager.listAll": [{
+		name: "deviceIds",
+		form: "array",
+		optional: true
+	}],
 	"deviceManager.loadConfig": [{
 		name: "deviceId",
 		form: "single",
@@ -36667,6 +36912,11 @@ Object.freeze({
 		form: "single",
 		optional: false
 	}],
+	"pipelineAnalytics.getGroup": [{
+		name: "deviceId",
+		form: "single",
+		optional: false
+	}],
 	"pipelineAnalytics.getKeyEvents": [{
 		name: "deviceId",
 		form: "single",
@@ -36722,6 +36972,11 @@ Object.freeze({
 		form: "array",
 		optional: false
 	}],
+	"pipelineAnalytics.listGroups": [{
+		name: "deviceIds",
+		form: "array",
+		optional: false
+	}],
 	"pipelineAnalytics.listOpsLog": [{
 		name: "deviceId",
 		form: "single",
@@ -38139,356 +38394,6 @@ async function silenceAnalysisFor(deps, deviceId) {
 	if (failures.length > 0) throw new Error(`terminal camera ${deviceId}: could not switch off ${failures.length} analyzer(s) — it will run at full detection cost (${failures.join("; ")})`);
 }
 //#endregion
-//#region src/terminal-camera-declarations.ts
-/**
-* Feed DeclaredDevices every live declaration plus one deterministic orphan
-* batch. The generic sweep intentionally refuses an over-limit set; selecting
-* a batch here drains large historical Terminal orphan sets across convergence
-* passes without weakening that global safety guard.
-*/
-function terminalCameraReconciliationIndex(rows, integrationId, declarations, managedStableIds = /* @__PURE__ */ new Set()) {
-	if (!integrationId) return [];
-	const declared = new Set(declarations.map((camera) => camera.stableId));
-	const owned = rows.filter((row) => row.integrationId === integrationId && (declared.has(row.stableId) || managedStableIds.has(row.stableId) || row.stableId.startsWith("terminal-camera-instance-")));
-	return [...owned.filter((row) => declared.has(row.stableId)), ...owned.filter((row) => !declared.has(row.stableId)).sort((left, right) => left.id - right.id).slice(0, 32)];
-}
-/** Explicit persisted instances, never the node × profile template matrix. */
-function buildTerminalInstanceCameraDeclarations(instances) {
-	return instances.filter((instance) => instance.enabled).map((instance) => ({
-		stableId: instance.cameraStableId,
-		name: instance.name,
-		config: {
-			instanceId: instance.id,
-			nodeId: instance.nodeId,
-			profileId: instance.profileId,
-			profileLabel: instance.profileLabel
-		}
-	}));
-}
-/**
-* `DeviceConfig` materializes schema defaults in memory, so comparing
-* `config.get()` cannot detect a legacy `{ nodeId }` row. Reconciliation must
-* inspect the raw persisted blob to make the profile migration durable.
-*/
-function needsTerminalCameraConfigMigration(persistedConfig, declaration) {
-	return persistedConfig.instanceId !== declaration.config.instanceId || persistedConfig.nodeId !== declaration.config.nodeId || persistedConfig.profileId !== declaration.config.profileId || persistedConfig.profileLabel !== declaration.config.profileLabel;
-}
-//#endregion
-//#region src/terminal-cell-runs.ts
-var TERMINAL_DEFAULT_FG = "#d7dce2";
-var TERMINAL_DEFAULT_BG = "#0b0d10";
-/**
-* The 16 ANSI colours, in a dark-theme variant chosen to sit with the existing
-* frame (`#0b0d10` ground, `#d7dce2` text) rather than the raw xterm defaults,
-* whose pure `#0000ff` blue and `#008000` green are close to unreadable on a
-* near-black background at 13px. Index 7 IS the default foreground, so plain
-* `CSI 37m` text renders identically to unstyled text.
-*/
-var TERMINAL_ANSI_PALETTE = [
-	"#282c34",
-	"#e06c75",
-	"#98c379",
-	"#e5c07b",
-	"#61afef",
-	"#c678dd",
-	"#56b6c2",
-	TERMINAL_DEFAULT_FG,
-	"#5c6370",
-	"#ef596f",
-	"#89ca78",
-	"#f0c674",
-	"#6cb6ff",
-	"#d55fde",
-	"#2bbac5",
-	"#ffffff"
-];
-/** The six levels of the xterm 6×6×6 colour cube (indices 16-231). */
-var TERMINAL_CUBE_LEVELS = [
-	0,
-	95,
-	135,
-	175,
-	215,
-	255
-];
-var TERMINAL_CUBE_FIRST = 16;
-var TERMINAL_GRAYSCALE_FIRST = 232;
-var TERMINAL_GRAYSCALE_BASE = 8;
-var TERMINAL_GRAYSCALE_STEP = 10;
-/** SGR 2 keeps the foreground legible; it must not become the background. */
-var TERMINAL_DIM_WEIGHT = .6;
-function channel(value) {
-	return Math.max(0, Math.min(255, Math.round(value))).toString(16).padStart(2, "0");
-}
-function hex(red, green, blue) {
-	return `#${channel(red)}${channel(green)}${channel(blue)}`;
-}
-function parseHex(color) {
-	return [
-		Number.parseInt(color.slice(1, 3), 16),
-		Number.parseInt(color.slice(3, 5), 16),
-		Number.parseInt(color.slice(5, 7), 16)
-	];
-}
-/** Resolve an xterm palette index (0-255) to a hex colour. */
-function terminalPaletteColor(index) {
-	const ansi = TERMINAL_ANSI_PALETTE[index];
-	if (ansi !== void 0) return ansi;
-	if (index >= TERMINAL_GRAYSCALE_FIRST) {
-		const level = TERMINAL_GRAYSCALE_BASE + (index - TERMINAL_GRAYSCALE_FIRST) * TERMINAL_GRAYSCALE_STEP;
-		return hex(level, level, level);
-	}
-	if (index >= TERMINAL_CUBE_FIRST) {
-		const offset = index - TERMINAL_CUBE_FIRST;
-		return hex(TERMINAL_CUBE_LEVELS[Math.floor(offset / 36) % 6] ?? 0, TERMINAL_CUBE_LEVELS[Math.floor(offset / 6) % 6] ?? 0, TERMINAL_CUBE_LEVELS[offset % 6] ?? 0);
-	}
-	return TERMINAL_DEFAULT_FG;
-}
-/** Resolve a 0xRRGGBB truecolor value to a hex colour. */
-function terminalRgbColor(value) {
-	return hex(value >> 16 & 255, value >> 8 & 255, value & 255);
-}
-function blend(color, toward, weight) {
-	const [red, green, blue] = parseHex(color);
-	const [targetRed, targetGreen, targetBlue] = parseHex(toward);
-	return hex(red * weight + targetRed * (1 - weight), green * weight + targetGreen * (1 - weight), blue * weight + targetBlue * (1 - weight));
-}
-function resolveForeground(cell) {
-	if (cell.isFgRGB()) return terminalRgbColor(cell.getFgColor());
-	if (cell.isFgPalette()) return terminalPaletteColor(cell.getFgColor());
-	return TERMINAL_DEFAULT_FG;
-}
-function resolveBackground(cell) {
-	if (cell.isBgRGB()) return terminalRgbColor(cell.getBgColor());
-	if (cell.isBgPalette()) return terminalPaletteColor(cell.getBgColor());
-	return TERMINAL_DEFAULT_BG;
-}
-/**
-* Resolve one cell's attributes into concrete colours.
-*
-* Inverse is applied by SWAPPING the already-resolved pair, so inverse over two
-* defaults is still a visible swap rather than a no-op — that is how a selected
-* or highlighted row in Glances reads. Invisible is then conceal-by-equality
-* (foreground painted in its own background): the cell keeps its columns, which
-* a dropped cell would not, and dropping it would shift the whole rest of the
-* row left.
-*/
-function resolveCellStyle(cell) {
-	const inverse = cell.isInverse() !== 0;
-	const plainFg = resolveForeground(cell);
-	const plainBg = resolveBackground(cell);
-	const background = inverse ? plainFg : plainBg;
-	let foreground = inverse ? plainBg : plainFg;
-	if (cell.isDim() !== 0) foreground = blend(foreground, background, TERMINAL_DIM_WEIGHT);
-	if (cell.isInvisible() !== 0) foreground = background;
-	return {
-		fg: foreground === "#d7dce2" ? null : foreground,
-		bg: background === "#0b0d10" ? null : background,
-		bold: cell.isBold() !== 0
-	};
-}
-function sameStyle(left, right) {
-	return left.fg === right.fg && left.bg === right.bg && left.bold === right.bold;
-}
-/**
-* Merge adjacent same-style cells into runs, then drop the trailing run of
-* default-styled whitespace so a row costs what it draws — the same trim
-* `translateToString(true)` performs. Whitespace carrying a BACKGROUND is kept:
-* a green bar of spaces out to the right margin is a pixel Glances drew.
-*/
-function buildCellRuns(cells) {
-	const runs = [];
-	let text = "";
-	let style = null;
-	for (const cell of cells) {
-		if (style !== null && sameStyle(style, cell.style)) {
-			text += cell.text;
-			continue;
-		}
-		if (style !== null) runs.push({
-			text,
-			...style
-		});
-		text = cell.text;
-		style = cell.style;
-	}
-	if (style !== null) runs.push({
-		text,
-		...style
-	});
-	while (runs.length > 0) {
-		const last = runs[runs.length - 1];
-		if (last === void 0 || last.bg !== null) break;
-		const trimmed = last.text.replace(/\s+$/u, "");
-		if (trimmed === last.text) break;
-		if (trimmed === "") {
-			runs.pop();
-			continue;
-		}
-		runs[runs.length - 1] = {
-			...last,
-			text: trimmed
-		};
-		break;
-	}
-	return runs;
-}
-/**
-* Monospace families to try, in order — NOT one family and a generic.
-*
-* A terminal screen is mostly box-drawing and block characters, and a font
-* without them renders the frame as noise rather than as missing detail.
-* `DejaVu Sans Mono` covers them and ships in the hub image; macOS has neither
-* DejaVu nor fontconfig, so the Mac agent fell through to a generic whose
-* coverage is not, and its Glances camera came out unreadable while the hub's
-* was pixel-perfect (measured 2026-08-11, same Glances, two nodes).
-*
-* `Menlo` is the fix rather than a guess: it is macOS's default terminal face,
-* present on every install, and derived from DejaVu Sans Mono — the same glyph
-* coverage by ancestry. Monaco and Courier New follow as older fallbacks; the
-* generic stays last so a host with none of them still draws something.
-*/
-var TERMINAL_FONT_STACK = "DejaVu Sans Mono,Menlo,Monaco,Courier New,monospace";
-var TERMINAL_FONT_SIZE = 13;
-var TERMINAL_TEXT_MARGIN_X = 8;
-var TERMINAL_ROW_HEIGHT = 15;
-var TERMINAL_BASELINE_Y = 18;
-/**
-* Distance from a row's baseline up to the top of its cell box. Chosen so
-* consecutive rows tile exactly: row N's box runs from `baseline - this` for
-* `TERMINAL_ROW_HEIGHT`, and row N+1's box starts where it ends. A background
-* bar that stopped short would draw as stripes across a `CSI 42m` panel.
-*/
-var TERMINAL_CELL_ASCENT = 11.5;
-var TERMINAL_CELL_WIDTH = TERMINAL_FONT_SIZE * (1233 / 2048);
-/** Two decimals is under a tenth of a pixel and keeps the SVG small. */
-function coordinate(value) {
-	return String(Number(value.toFixed(2)));
-}
-function escapeXml(value) {
-	return value.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll("\"", "&quot;").replaceAll("'", "&apos;");
-}
-/**
-* Render already-interpreted terminal rows into a compact MJPEG frame.
-*
-* `xml:space="preserve"` is load-bearing, not tidiness. SVG `<text>` collapses
-* runs of whitespace by default, and a terminal's entire column alignment IS
-* runs of whitespace — Glances pads every field with spaces. Without it the
-* frame drew each line at roughly half its true width, crammed into the
-* top-left of a mostly-black image, while the SAME session over `attach`
-* looked perfect — which is exactly how the operator reported it. Measured in
-* the hub's own rasterizer 2026-08-11: `AAA<10 spaces>BBB<3>CCC` drew 92 px
-* collapsed against 178 px preserved.
-*
-* Every run is anchored at its OWN column (`x = margin + startCol * cellW`),
-* never appended to the one before it, so the background rects and the glyphs
-* are placed off the same grid and cannot drift apart. `textLength` is emitted
-* with it because it is the correct declaration and renderers that honour it
-* get an exact grid — but it is not what makes this work: librsvg, which sharp
-* uses, ignores it outright (measured 2026-08-12, a 120-glyph run pinned to
-* 600 px still drew its natural 937 px). The anchoring is the guarantee.
-*/
-function renderTerminalSvg(rows) {
-	const backgrounds = [];
-	const texts = [];
-	rows.slice(0, 40).forEach((row, index) => {
-		const baseline = TERMINAL_BASELINE_Y + index * TERMINAL_ROW_HEIGHT;
-		const top = baseline - TERMINAL_CELL_ASCENT;
-		let column = 0;
-		for (const run of row) {
-			if (column >= 120) break;
-			const clipped = clipRun(run, 120 - column);
-			const columns = [...clipped].length;
-			if (columns === 0) continue;
-			const x = TERMINAL_TEXT_MARGIN_X + column * TERMINAL_CELL_WIDTH;
-			const width = columns * TERMINAL_CELL_WIDTH;
-			if (run.bg !== null) backgrounds.push(`<rect x="${coordinate(x)}" y="${coordinate(top)}" width="${coordinate(width)}" height="${String(TERMINAL_ROW_HEIGHT)}" fill="${run.bg}"/>`);
-			if (clipped.trim() !== "") {
-				const fill = run.fg === null ? "" : ` fill="${run.fg}"`;
-				const weight = run.bold ? " font-weight=\"bold\"" : "";
-				texts.push(`<text xml:space="preserve" x="${coordinate(x)}" y="${coordinate(baseline)}" textLength="${coordinate(width)}" lengthAdjust="spacingAndGlyphs"${fill}${weight}>${escapeXml(clipped)}</text>`);
-			}
-			column += columns;
-		}
-	});
-	return `<svg xmlns="http://www.w3.org/2000/svg" width="${String(960)}" height="${String(640)}"><rect width="100%" height="100%" fill="${TERMINAL_DEFAULT_BG}"/>${backgrounds.join("")}<g fill="${TERMINAL_DEFAULT_FG}" font-family="${TERMINAL_FONT_STACK}" font-size="${String(TERMINAL_FONT_SIZE)}">${texts.join("")}</g></svg>`;
-}
-/** Cut a run to the columns still left in the row, by code point not unit. */
-function clipRun(run, remaining) {
-	const points = [...run.text];
-	return points.length <= remaining ? run.text : points.slice(0, remaining).join("");
-}
-async function renderTerminalJpeg(rows) {
-	return (0, sharp.default)(Buffer.from(renderTerminalSvg(rows))).jpeg({
-		quality: 82,
-		chromaSubsampling: "4:2:0"
-	}).toBuffer();
-}
-//#endregion
-//#region src/terminal-camera-device.ts
-var terminalCameraSchema = object({
-	instanceId: string().min(1).optional(),
-	nodeId: string().min(1),
-	profileId: string().min(1).default("monitor"),
-	profileLabel: string().min(1).default("BTM")
-});
-var relay = null;
-function installTerminalCameraRelay(next) {
-	relay = next;
-}
-var TerminalCameraDevice = class extends BaseDevice {
-	features = [DeviceFeature.NativeSnapshot];
-	constructor(ctx) {
-		super(ctx, terminalCameraSchema, { type: ctx.deviceMeta.type });
-		this.ctx.registerNativeCap(streamCatalogCapability, { getCatalog: async ({ deviceId }) => {
-			if (deviceId !== this.id) return [];
-			return this.catalog();
-		} });
-		this.ctx.registerNativeCap(snapshotCapability, {
-			getSnapshot: async ({ deviceId }) => {
-				if (deviceId !== this.id) throw new Error(`TerminalCameraDevice: deviceId mismatch, expected ${String(this.id)}, got ${String(deviceId)}`);
-				const activeRelay = relay;
-				if (!activeRelay) throw new Error("terminal camera relay is unavailable");
-				return {
-					base64: (await activeRelay.snapshot(this.relayInstanceId(), this.config.get("nodeId"), this.config.get("profileId"))).toString("base64"),
-					contentType: "image/jpeg"
-				};
-			},
-			invalidateCache: async () => {}
-		});
-		this.markOnline(true);
-	}
-	async catalog() {
-		const activeRelay = relay;
-		if (!activeRelay) throw new Error("terminal camera relay is unavailable");
-		const nodeId = this.config.get("nodeId");
-		const profileId = this.config.get("profileId");
-		const instanceId = this.relayInstanceId();
-		return [{
-			camStreamId: profileId,
-			kind: "pull-http",
-			url: activeRelay.streamUrl(instanceId, nodeId, profileId),
-			codec: "h264",
-			resolution: {
-				width: 960,
-				height: 640
-			},
-			fps: 2,
-			label: this.config.get("profileLabel")
-		}];
-	}
-	setNodeOnline(online) {
-		this.markOnline(online);
-		if (!online) relay?.closeInstance(this.relayInstanceId());
-	}
-	async removeDevice() {
-		await relay?.closeInstance(this.relayInstanceId());
-	}
-	relayInstanceId() {
-		return this.config.get("instanceId") ?? `legacy:${this.stableId}`;
-	}
-};
-//#endregion
 //#region ../../node_modules/@xterm/addon-serialize/lib/addon-serialize.js
 var require_addon_serialize = /* @__PURE__ */ __commonJSMin(((exports, module) => {
 	(function(e, t) {
@@ -43296,11 +43201,176 @@ var require_xterm_headless = /* @__PURE__ */ __commonJSMin(((exports) => {
 	})();
 }));
 //#endregion
-//#region src/xterm-screen.ts
+//#region src/terminal-cell-runs.ts
 var import_addon_serialize = require_addon_serialize();
 var import_xterm_headless = require_xterm_headless();
+var TERMINAL_DEFAULT_FG = "#d7dce2";
+var TERMINAL_DEFAULT_BG = "#0b0d10";
+/**
+* The 16 ANSI colours, in a dark-theme variant chosen to sit with the existing
+* frame (`#0b0d10` ground, `#d7dce2` text) rather than the raw xterm defaults,
+* whose pure `#0000ff` blue and `#008000` green are close to unreadable on a
+* near-black background at 13px. Index 7 IS the default foreground, so plain
+* `CSI 37m` text renders identically to unstyled text.
+*/
+var TERMINAL_ANSI_PALETTE = [
+	"#282c34",
+	"#e06c75",
+	"#98c379",
+	"#e5c07b",
+	"#61afef",
+	"#c678dd",
+	"#56b6c2",
+	TERMINAL_DEFAULT_FG,
+	"#5c6370",
+	"#ef596f",
+	"#89ca78",
+	"#f0c674",
+	"#6cb6ff",
+	"#d55fde",
+	"#2bbac5",
+	"#ffffff"
+];
+/** The six levels of the xterm 6×6×6 colour cube (indices 16-231). */
+var TERMINAL_CUBE_LEVELS = [
+	0,
+	95,
+	135,
+	175,
+	215,
+	255
+];
+var TERMINAL_CUBE_FIRST = 16;
+var TERMINAL_GRAYSCALE_FIRST = 232;
+var TERMINAL_GRAYSCALE_BASE = 8;
+var TERMINAL_GRAYSCALE_STEP = 10;
+/** SGR 2 keeps the foreground legible; it must not become the background. */
+var TERMINAL_DIM_WEIGHT = .6;
+function channel(value) {
+	return Math.max(0, Math.min(255, Math.round(value))).toString(16).padStart(2, "0");
+}
+function hex(red, green, blue) {
+	return `#${channel(red)}${channel(green)}${channel(blue)}`;
+}
+function parseHex(color) {
+	return [
+		Number.parseInt(color.slice(1, 3), 16),
+		Number.parseInt(color.slice(3, 5), 16),
+		Number.parseInt(color.slice(5, 7), 16)
+	];
+}
+/** Resolve an xterm palette index (0-255) to a hex colour. */
+function terminalPaletteColor(index) {
+	const ansi = TERMINAL_ANSI_PALETTE[index];
+	if (ansi !== void 0) return ansi;
+	if (index >= TERMINAL_GRAYSCALE_FIRST) {
+		const level = TERMINAL_GRAYSCALE_BASE + (index - TERMINAL_GRAYSCALE_FIRST) * TERMINAL_GRAYSCALE_STEP;
+		return hex(level, level, level);
+	}
+	if (index >= TERMINAL_CUBE_FIRST) {
+		const offset = index - TERMINAL_CUBE_FIRST;
+		return hex(TERMINAL_CUBE_LEVELS[Math.floor(offset / 36) % 6] ?? 0, TERMINAL_CUBE_LEVELS[Math.floor(offset / 6) % 6] ?? 0, TERMINAL_CUBE_LEVELS[offset % 6] ?? 0);
+	}
+	return TERMINAL_DEFAULT_FG;
+}
+/** Resolve a 0xRRGGBB truecolor value to a hex colour. */
+function terminalRgbColor(value) {
+	return hex(value >> 16 & 255, value >> 8 & 255, value & 255);
+}
+function blend(color, toward, weight) {
+	const [red, green, blue] = parseHex(color);
+	const [targetRed, targetGreen, targetBlue] = parseHex(toward);
+	return hex(red * weight + targetRed * (1 - weight), green * weight + targetGreen * (1 - weight), blue * weight + targetBlue * (1 - weight));
+}
+function resolveForeground(cell) {
+	if (cell.isFgRGB()) return terminalRgbColor(cell.getFgColor());
+	if (cell.isFgPalette()) return terminalPaletteColor(cell.getFgColor());
+	return TERMINAL_DEFAULT_FG;
+}
+function resolveBackground(cell) {
+	if (cell.isBgRGB()) return terminalRgbColor(cell.getBgColor());
+	if (cell.isBgPalette()) return terminalPaletteColor(cell.getBgColor());
+	return TERMINAL_DEFAULT_BG;
+}
+/**
+* Resolve one cell's attributes into concrete colours.
+*
+* Inverse is applied by SWAPPING the already-resolved pair, so inverse over two
+* defaults is still a visible swap rather than a no-op — that is how a selected
+* or highlighted row in Glances reads. Invisible is then conceal-by-equality
+* (foreground painted in its own background): the cell keeps its columns, which
+* a dropped cell would not, and dropping it would shift the whole rest of the
+* row left.
+*/
+function resolveCellStyle(cell) {
+	const inverse = cell.isInverse() !== 0;
+	const plainFg = resolveForeground(cell);
+	const plainBg = resolveBackground(cell);
+	const background = inverse ? plainFg : plainBg;
+	let foreground = inverse ? plainBg : plainFg;
+	if (cell.isDim() !== 0) foreground = blend(foreground, background, TERMINAL_DIM_WEIGHT);
+	if (cell.isInvisible() !== 0) foreground = background;
+	return {
+		fg: foreground === "#d7dce2" ? null : foreground,
+		bg: background === "#0b0d10" ? null : background,
+		bold: cell.isBold() !== 0
+	};
+}
+function sameStyle(left, right) {
+	return left.fg === right.fg && left.bg === right.bg && left.bold === right.bold;
+}
+/**
+* Merge adjacent same-style cells into runs, then drop the trailing run of
+* default-styled whitespace so a row costs what it draws — the same trim
+* `translateToString(true)` performs. Whitespace carrying a BACKGROUND is kept:
+* a green bar of spaces out to the right margin is a pixel Glances drew.
+*/
+function buildCellRuns(cells) {
+	const runs = [];
+	let text = "";
+	let style = null;
+	for (const cell of cells) {
+		if (style !== null && sameStyle(style, cell.style)) {
+			text += cell.text;
+			continue;
+		}
+		if (style !== null) runs.push({
+			text,
+			...style
+		});
+		text = cell.text;
+		style = cell.style;
+	}
+	if (style !== null) runs.push({
+		text,
+		...style
+	});
+	while (runs.length > 0) {
+		const last = runs[runs.length - 1];
+		if (last === void 0 || last.bg !== null) break;
+		const trimmed = last.text.replace(/\s+$/u, "");
+		if (trimmed === last.text) break;
+		if (trimmed === "") {
+			runs.pop();
+			continue;
+		}
+		runs[runs.length - 1] = {
+			...last,
+			text: trimmed
+		};
+		break;
+	}
+	return runs;
+}
+//#endregion
+//#region src/xterm-screen.ts
+/**
+* Real {@link ScreenBuffer} backed by `@xterm/headless` — the DOM-less xterm
+* build — plus the serialize addon, which turns the current buffer into a
+* self-contained repaint escape sequence for reconnecting clients.
+*/
 var SCROLLBACK_LINES = 2e3;
-function createXtermScreen$1(cols, rows) {
+function createXtermScreen(cols, rows) {
 	const term = new import_xterm_headless.Terminal({
 		cols,
 		rows,
@@ -43365,6 +43435,196 @@ function createXtermScreen$1(cols, rows) {
 	};
 }
 //#endregion
+//#region src/terminal-camera-declarations.ts
+/**
+* Feed DeclaredDevices every live declaration plus one deterministic orphan
+* batch. The generic sweep intentionally refuses an over-limit set; selecting
+* a batch here drains large historical Terminal orphan sets across convergence
+* passes without weakening that global safety guard.
+*/
+function terminalCameraReconciliationIndex(rows, integrationId, declarations, managedStableIds = /* @__PURE__ */ new Set()) {
+	if (!integrationId) return [];
+	const declared = new Set(declarations.map((camera) => camera.stableId));
+	const owned = rows.filter((row) => row.integrationId === integrationId && (declared.has(row.stableId) || managedStableIds.has(row.stableId) || row.stableId.startsWith("terminal-camera-instance-")));
+	return [...owned.filter((row) => declared.has(row.stableId)), ...owned.filter((row) => !declared.has(row.stableId)).sort((left, right) => left.id - right.id).slice(0, 32)];
+}
+/** Explicit persisted instances, never the node × profile template matrix. */
+function buildTerminalInstanceCameraDeclarations(instances) {
+	return instances.filter((instance) => instance.enabled).map((instance) => ({
+		stableId: instance.cameraStableId,
+		name: instance.name,
+		config: {
+			instanceId: instance.id,
+			nodeId: instance.nodeId,
+			profileId: instance.profileId,
+			profileLabel: instance.profileLabel
+		}
+	}));
+}
+/**
+* `DeviceConfig` materializes schema defaults in memory, so comparing
+* `config.get()` cannot detect a legacy `{ nodeId }` row. Reconciliation must
+* inspect the raw persisted blob to make the profile migration durable.
+*/
+function needsTerminalCameraConfigMigration(persistedConfig, declaration) {
+	return persistedConfig.instanceId !== declaration.config.instanceId || persistedConfig.nodeId !== declaration.config.nodeId || persistedConfig.profileId !== declaration.config.profileId || persistedConfig.profileLabel !== declaration.config.profileLabel;
+}
+/**
+* Monospace families to try, in order — NOT one family and a generic.
+*
+* A terminal screen is mostly box-drawing and block characters, and a font
+* without them renders the frame as noise rather than as missing detail.
+* `DejaVu Sans Mono` covers them and ships in the hub image; macOS has neither
+* DejaVu nor fontconfig, so the Mac agent fell through to a generic whose
+* coverage is not, and its Glances camera came out unreadable while the hub's
+* was pixel-perfect (measured 2026-08-11, same Glances, two nodes).
+*
+* `Menlo` is the fix rather than a guess: it is macOS's default terminal face,
+* present on every install, and derived from DejaVu Sans Mono — the same glyph
+* coverage by ancestry. Monaco and Courier New follow as older fallbacks; the
+* generic stays last so a host with none of them still draws something.
+*/
+var TERMINAL_FONT_STACK = "DejaVu Sans Mono,Menlo,Monaco,Courier New,monospace";
+var TERMINAL_FONT_SIZE = 13;
+var TERMINAL_TEXT_MARGIN_X = 8;
+var TERMINAL_ROW_HEIGHT = 15;
+var TERMINAL_BASELINE_Y = 18;
+/**
+* Distance from a row's baseline up to the top of its cell box. Chosen so
+* consecutive rows tile exactly: row N's box runs from `baseline - this` for
+* `TERMINAL_ROW_HEIGHT`, and row N+1's box starts where it ends. A background
+* bar that stopped short would draw as stripes across a `CSI 42m` panel.
+*/
+var TERMINAL_CELL_ASCENT = 11.5;
+var TERMINAL_CELL_WIDTH = TERMINAL_FONT_SIZE * (1233 / 2048);
+/** Two decimals is under a tenth of a pixel and keeps the SVG small. */
+function coordinate(value) {
+	return String(Number(value.toFixed(2)));
+}
+function escapeXml(value) {
+	return value.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll("\"", "&quot;").replaceAll("'", "&apos;");
+}
+/**
+* Render already-interpreted terminal rows into a compact MJPEG frame.
+*
+* `xml:space="preserve"` is load-bearing, not tidiness. SVG `<text>` collapses
+* runs of whitespace by default, and a terminal's entire column alignment IS
+* runs of whitespace — Glances pads every field with spaces. Without it the
+* frame drew each line at roughly half its true width, crammed into the
+* top-left of a mostly-black image, while the SAME session over `attach`
+* looked perfect — which is exactly how the operator reported it. Measured in
+* the hub's own rasterizer 2026-08-11: `AAA<10 spaces>BBB<3>CCC` drew 92 px
+* collapsed against 178 px preserved.
+*
+* Every run is anchored at its OWN column (`x = margin + startCol * cellW`),
+* never appended to the one before it, so the background rects and the glyphs
+* are placed off the same grid and cannot drift apart. `textLength` is emitted
+* with it because it is the correct declaration and renderers that honour it
+* get an exact grid — but it is not what makes this work: librsvg, which sharp
+* uses, ignores it outright (measured 2026-08-12, a 120-glyph run pinned to
+* 600 px still drew its natural 937 px). The anchoring is the guarantee.
+*/
+function renderTerminalSvg(rows) {
+	const backgrounds = [];
+	const texts = [];
+	rows.slice(0, 40).forEach((row, index) => {
+		const baseline = TERMINAL_BASELINE_Y + index * TERMINAL_ROW_HEIGHT;
+		const top = baseline - TERMINAL_CELL_ASCENT;
+		let column = 0;
+		for (const run of row) {
+			if (column >= 120) break;
+			const clipped = clipRun(run, 120 - column);
+			const columns = [...clipped].length;
+			if (columns === 0) continue;
+			const x = TERMINAL_TEXT_MARGIN_X + column * TERMINAL_CELL_WIDTH;
+			const width = columns * TERMINAL_CELL_WIDTH;
+			if (run.bg !== null) backgrounds.push(`<rect x="${coordinate(x)}" y="${coordinate(top)}" width="${coordinate(width)}" height="${String(TERMINAL_ROW_HEIGHT)}" fill="${run.bg}"/>`);
+			if (clipped.trim() !== "") {
+				const fill = run.fg === null ? "" : ` fill="${run.fg}"`;
+				const weight = run.bold ? " font-weight=\"bold\"" : "";
+				texts.push(`<text xml:space="preserve" x="${coordinate(x)}" y="${coordinate(baseline)}" textLength="${coordinate(width)}" lengthAdjust="spacingAndGlyphs"${fill}${weight}>${escapeXml(clipped)}</text>`);
+			}
+			column += columns;
+		}
+	});
+	return `<svg xmlns="http://www.w3.org/2000/svg" width="${String(960)}" height="${String(640)}"><rect width="100%" height="100%" fill="${TERMINAL_DEFAULT_BG}"/>${backgrounds.join("")}<g fill="${TERMINAL_DEFAULT_FG}" font-family="${TERMINAL_FONT_STACK}" font-size="${String(TERMINAL_FONT_SIZE)}">${texts.join("")}</g></svg>`;
+}
+/** Cut a run to the columns still left in the row, by code point not unit. */
+function clipRun(run, remaining) {
+	const points = [...run.text];
+	return points.length <= remaining ? run.text : points.slice(0, remaining).join("");
+}
+async function renderTerminalJpeg(rows) {
+	return (0, sharp.default)(Buffer.from(renderTerminalSvg(rows))).jpeg({
+		quality: 82,
+		chromaSubsampling: "4:2:0"
+	}).toBuffer();
+}
+//#endregion
+//#region src/terminal-camera-device.ts
+var terminalCameraSchema = object({
+	instanceId: string().min(1).optional(),
+	nodeId: string().min(1),
+	profileId: string().min(1).default("monitor"),
+	profileLabel: string().min(1).default("BTM")
+});
+var relay = null;
+function installTerminalCameraRelay(next) {
+	relay = next;
+}
+var TerminalCameraDevice = class extends BaseDevice {
+	features = [DeviceFeature.NativeSnapshot];
+	constructor(ctx) {
+		super(ctx, terminalCameraSchema, { type: ctx.deviceMeta.type });
+		this.ctx.registerNativeCap(streamCatalogCapability, { getCatalog: async ({ deviceId }) => {
+			if (deviceId !== this.id) return [];
+			return this.catalog();
+		} });
+		this.ctx.registerNativeCap(snapshotCapability, {
+			getSnapshot: async ({ deviceId }) => {
+				if (deviceId !== this.id) throw new Error(`TerminalCameraDevice: deviceId mismatch, expected ${String(this.id)}, got ${String(deviceId)}`);
+				const activeRelay = relay;
+				if (!activeRelay) throw new Error("terminal camera relay is unavailable");
+				return {
+					base64: (await activeRelay.snapshot(this.relayInstanceId(), this.config.get("nodeId"), this.config.get("profileId"))).toString("base64"),
+					contentType: "image/jpeg"
+				};
+			},
+			invalidateCache: async () => {}
+		});
+		this.markOnline(true);
+	}
+	async catalog() {
+		const activeRelay = relay;
+		if (!activeRelay) throw new Error("terminal camera relay is unavailable");
+		const nodeId = this.config.get("nodeId");
+		const profileId = this.config.get("profileId");
+		const instanceId = this.relayInstanceId();
+		return [{
+			camStreamId: profileId,
+			kind: "pull-http",
+			url: activeRelay.streamUrl(instanceId, nodeId, profileId),
+			codec: "h264",
+			resolution: {
+				width: 960,
+				height: 640
+			},
+			fps: 2,
+			label: this.config.get("profileLabel")
+		}];
+	}
+	setNodeOnline(online) {
+		this.markOnline(online);
+		if (!online) relay?.closeInstance(this.relayInstanceId());
+	}
+	async removeDevice() {
+		await relay?.closeInstance(this.relayInstanceId());
+	}
+	relayInstanceId() {
+		return this.config.get("instanceId") ?? `legacy:${this.stableId}`;
+	}
+};
+//#endregion
 //#region src/terminal-camera-relay.ts
 var MJPEG_BOUNDARY = "camstack-terminal-frame";
 var SESSION_IDLE_MS = 3e4;
@@ -43444,7 +43704,7 @@ var TerminalCameraRelay = class {
 			instanceId,
 			nodeId,
 			profileId,
-			screen: createXtermScreen$1(120, 40),
+			screen: createXtermScreen(120, 40),
 			sessionId: null,
 			cursor: 0,
 			clients: 0,
@@ -43501,7 +43761,7 @@ var TerminalCameraRelay = class {
 	applyBatch(state, batch) {
 		if (batch.reset) {
 			state.screen.dispose();
-			state.screen = createXtermScreen$1(120, 40);
+			state.screen = createXtermScreen(120, 40);
 			if (batch.snapshot) state.screen.write(batch.snapshot);
 		}
 		let exited = false;
@@ -45267,7 +45527,7 @@ exports.buildCellRuns = buildCellRuns;
 exports.buildProfiles = buildProfiles;
 exports.createNodePtySpawner = createNodePtySpawner;
 exports.createTerminalDataPlaneHandler = createTerminalDataPlaneHandler;
-exports.createXtermScreen = createXtermScreen$1;
+exports.createXtermScreen = createXtermScreen;
 exports.findProfile = findProfile;
 exports.resolveCellStyle = resolveCellStyle;
 exports.terminalPaletteColor = terminalPaletteColor;