@camstack/types 1.2.103 → 1.2.104

package/dist/addon.js

@@ -1,6 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_event_category = require("./event-category-EY0GNjV9.js");
-const require_sleep = require("./sleep-CizGYrCD.js");
+const require_sleep = require("./sleep-CUuoW-kk.js");
 const require_err_msg = require("./err-msg-COpsHMw2.js");
 //#region src/generated/cap-input-defaults.ts
 /**

package/dist/addon.mjs

@@ -1,5 +1,5 @@
 import { t as EventCategory } from "./event-category-CIa_iT6b.mjs";
-import { B as ReadinessRegistry, E as adminUiCapability, L as nodePin, R as readNodePin, St as emitReadiness, T as DeviceType, V as ReadinessTimeoutError, W as scopeKey, _t as DisposerChain, a as asJsonObject, b as deviceOpsCapability, d as BOOT_RECOVERY_BACKOFF_MS, f as DEVICE_SCOPED_CAPS, gt as DATAPLANE_SECRET_HEADER, h as createEventBusSliceSource, j as expandCapMethods, m as createDeviceProxy, p as isDeviceScopedCap, s as asString, t as sleep, u as parseJsonUnknown, vt as BaseAddon, x as viewerUiCapability, yt as normalizeAddonInitResult } from "./sleep-Cs9MWLcT.mjs";
+import { B as ReadinessRegistry, E as adminUiCapability, L as nodePin, R as readNodePin, St as emitReadiness, T as DeviceType, V as ReadinessTimeoutError, W as scopeKey, _t as DisposerChain, a as asJsonObject, b as deviceOpsCapability, d as BOOT_RECOVERY_BACKOFF_MS, f as DEVICE_SCOPED_CAPS, gt as DATAPLANE_SECRET_HEADER, h as createEventBusSliceSource, j as expandCapMethods, m as createDeviceProxy, p as isDeviceScopedCap, s as asString, t as sleep, u as parseJsonUnknown, vt as BaseAddon, x as viewerUiCapability, yt as normalizeAddonInitResult } from "./sleep-BLxqGLY0.mjs";
 import { t as errMsg } from "./err-msg-IQTHeDzc.mjs";
 //#region src/generated/cap-input-defaults.ts
 /**

package/dist/capabilities/device-manager.cap.d.ts

@@ -114,6 +114,41 @@ export declare const LinkedDeviceSchema: z.ZodObject<{
     producesTrackedEvents: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$strip>;
 export type LinkedDevice = z.infer<typeof LinkedDeviceSchema>;
+/** 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. */
+export declare const LinkedDevicesForDeviceSchema: z.ZodObject<{
+    deviceId: z.ZodNumber;
+    mode: z.ZodEnum<{
+        manual: "manual";
+        auto: "auto";
+    }>;
+    devices: z.ZodArray<z.ZodObject<{
+        deviceId: z.ZodNumber;
+        name: z.ZodString;
+        location: z.ZodNullable<z.ZodString>;
+        features: z.ZodArray<z.ZodString>;
+        producesTrackedEvents: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type LinkedDevicesForDevice = z.infer<typeof LinkedDevicesForDeviceSchema>;
+/** 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. */
+export declare const DeviceBindingsForDeviceSchema: z.ZodObject<{
+    deviceId: z.ZodNumber;
+    entries: z.ZodArray<z.ZodObject<{
+        capName: z.ZodString;
+        kind: z.ZodEnum<{
+            native: "native";
+            wrapped: "wrapped";
+        }>;
+        providerAddonId: z.ZodString;
+        providerNodeId: z.ZodString;
+        nativeAddonId: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type DeviceBindingsForDevice = z.infer<typeof DeviceBindingsForDeviceSchema>;
 export { StreamSourceEntrySchema };
 export declare const SavedDeviceRowSchema: z.ZodObject<{
     id: z.ZodNumber;
@@ -504,6 +539,7 @@ export declare const deviceManagerCapability: {
                 slim: "slim";
             }>>;
             isCamera: z.ZodOptional<z.ZodBoolean>;
+            deviceIds: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
         }, z.core.$strip>, z.ZodArray<z.ZodObject<{
             id: z.ZodNumber;
             stableId: z.ZodString;
@@ -663,6 +699,38 @@ export declare const deviceManagerCapability: {
                 producesTrackedEvents: z.ZodOptional<z.ZodBoolean>;
             }, z.core.$strip>>;
         }, z.core.$strip>, import("./capability-definition.js").CapabilityMethodKind>;
+        /**
+         * `getLinkedDevices` for MANY cameras, in one call.
+         *
+         * Not a convenience wrapper — a cost fix. Resolving one camera's linked set
+         * needs the whole fleet as candidates (children ∪ same-location), so the
+         * single-device path runs a full `listAll` per call. Asked per camera that
+         * is N full-fleet sweeps of device-manager's event loop, and they do not
+         * overlap: measured on the live hub 2026-08-25, 30 concurrent
+         * `getLinkedDevices` took 4110 ms wall (median 4060 ms each) to return
+         * 7260 bytes in total. The batch takes ONE sweep and one settings read per
+         * camera.
+         *
+         * A device id that resolves to nothing still gets a row (`devices: []`) —
+         * a caller that asked for thirty and got twenty-eight cannot tell which two
+         * are missing, or that any are.
+         */
+        readonly getLinkedDevicesBatch: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
+            deviceIds: z.ZodArray<z.ZodNumber>;
+        }, z.core.$strip>, z.ZodArray<z.ZodObject<{
+            deviceId: z.ZodNumber;
+            mode: z.ZodEnum<{
+                manual: "manual";
+                auto: "auto";
+            }>;
+            devices: z.ZodArray<z.ZodObject<{
+                deviceId: z.ZodNumber;
+                name: z.ZodString;
+                location: z.ZodNullable<z.ZodString>;
+                features: z.ZodArray<z.ZodString>;
+                producesTrackedEvents: z.ZodOptional<z.ZodBoolean>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>>, import("./capability-definition.js").CapabilityMethodKind>;
         /** Get stream sources for a camera device. */
         readonly getStreamSources: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
             deviceId: z.ZodNumber;
@@ -779,6 +847,35 @@ export declare const deviceManagerCapability: {
                 nativeAddonId: z.ZodString;
             }, z.core.$strip>>;
         }, z.core.$strip>, import("./capability-definition.js").CapabilityMethodKind>;
+        /**
+         * `getBindings` for a NAMED set of devices, in one call.
+         *
+         * Between `getBindings` (one device) and `getAllBindings` (all 988) there
+         * was nothing, so a caller that needs seventy-five either pays
+         * seventy-five round-trips or drags the whole fleet across. Measured on
+         * the live hub 2026-08-25: 75 concurrent `getBindings` = 1211 ms / 118 KB,
+         * `getAllBindings({})` = 511 ms / 679 KB. Neither is the right answer to
+         * "these seventy-five".
+         *
+         * Same resolver, same routing rules, same per-device shape as
+         * `getBindings`; ids are deduped and a device with no bindings answers
+         * `entries: []` rather than dropping out.
+         */
+        readonly getBindingsBatch: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
+            deviceIds: z.ZodArray<z.ZodNumber>;
+        }, z.core.$strip>, z.ZodArray<z.ZodObject<{
+            deviceId: z.ZodNumber;
+            entries: z.ZodArray<z.ZodObject<{
+                capName: z.ZodString;
+                kind: z.ZodEnum<{
+                    native: "native";
+                    wrapped: "wrapped";
+                }>;
+                providerAddonId: z.ZodString;
+                providerNodeId: z.ZodString;
+                nativeAddonId: z.ZodString;
+            }, z.core.$strip>>;
+        }, z.core.$strip>>, import("./capability-definition.js").CapabilityMethodKind>;
         /**
          * Return the binding map for every device known to the hub. Used by
          * `SystemManager` warm-boot: a single round-trip resolves the

package/dist/generated/addon-api.d.ts

@@ -2219,6 +2219,13 @@ export type AppRouter = TrpcCoreRouter<{
             output: z.infer<typeof deviceManagerCapability.methods.getLinkedDevices.output>;
             meta: object;
         }>;
+        getLinkedDevicesBatch: TRPCQueryProcedure<{
+            input: {
+                [x: string]: unknown;
+            } & z.input<typeof deviceManagerCapability.methods.getLinkedDevicesBatch.input>;
+            output: z.infer<typeof deviceManagerCapability.methods.getLinkedDevicesBatch.output>;
+            meta: object;
+        }>;
         getStreamSources: TRPCQueryProcedure<{
             input: {
                 [x: string]: unknown;
@@ -2303,6 +2310,13 @@ export type AppRouter = TrpcCoreRouter<{
             output: z.infer<typeof deviceManagerCapability.methods.getBindings.output>;
             meta: object;
         }>;
+        getBindingsBatch: TRPCQueryProcedure<{
+            input: {
+                [x: string]: unknown;
+            } & z.input<typeof deviceManagerCapability.methods.getBindingsBatch.input>;
+            output: z.infer<typeof deviceManagerCapability.methods.getBindingsBatch.output>;
+            meta: object;
+        }>;
         getAllBindings: TRPCQueryProcedure<{
             input: {
                 [x: string]: unknown;

package/dist/generated/device-proxy.d.ts

@@ -271,7 +271,7 @@ export interface DeviceProxy {
     readonly cameraPipelineConfig: Pick<InferDeviceProxyCap<typeof cameraPipelineConfigCapability>, 'getDeviceSettingsContribution' | 'getDeviceLiveContribution' | 'applyDeviceSettingsPatch'>;
     readonly deviceAdoption: Pick<InferDeviceProxyCap<typeof deviceAdoptionCapability>, 'getStatus'>;
     readonly deviceExport: Pick<InferDeviceProxyCap<typeof deviceExportCapability>, 'getDeviceSettingsContribution' | 'getDeviceLiveContribution' | 'applyDeviceSettingsPatch'>;
-    readonly deviceManager: Pick<InferDeviceProxyCap<typeof deviceManagerCapability>, 'loadConfig' | 'loadRuntimeState' | 'loadMeta' | 'setName' | 'setLocation' | 'setType' | 'setIntegrationId' | 'setLinkDeviceId' | 'setPrimaryChildEntityId' | 'setChildLayout' | 'setDisplay' | 'getWireableFields' | 'setRole' | 'applyInitialMeta' | 'setMetadata' | 'setDisabled' | 'getDevice' | 'getLinkedDevices' | 'getStreamSources' | 'getConfigSchema' | 'getSettingsSchema' | 'updateConfig' | 'enable' | 'disable' | 'remove' | 'getStreamProfileMap' | 'setStreamProfileMap' | 'probeStreams' | 'getBindings' | 'getAllBindings' | 'setWrapperActive' | 'getDeviceSettingsAggregate' | 'getDeviceLiveInfoAggregate' | 'getDeviceAggregate' | 'runDeviceAction' | 'updateDeviceField' | 'updateDeviceFieldsBatch' | 'testField' | 'getDeviceStatusAggregate' | 'getDeviceSettingsContribution' | 'getDeviceLiveContribution' | 'applyDeviceSettingsPatch'>;
+    readonly deviceManager: Pick<InferDeviceProxyCap<typeof deviceManagerCapability>, 'loadConfig' | 'loadRuntimeState' | 'loadMeta' | 'setName' | 'setLocation' | 'setType' | 'setIntegrationId' | 'setLinkDeviceId' | 'setPrimaryChildEntityId' | 'setChildLayout' | 'setDisplay' | 'getWireableFields' | 'setRole' | 'applyInitialMeta' | 'setMetadata' | 'setDisabled' | 'getDevice' | 'getLinkedDevices' | 'getStreamSources' | 'getConfigSchema' | 'getSettingsSchema' | 'updateConfig' | 'enable' | 'disable' | 'remove' | 'getStreamProfileMap' | 'setStreamProfileMap' | 'probeStreams' | 'getBindings' | 'setWrapperActive' | 'getDeviceSettingsAggregate' | 'getDeviceLiveInfoAggregate' | 'getDeviceAggregate' | 'runDeviceAction' | 'updateDeviceField' | 'updateDeviceFieldsBatch' | 'testField' | 'getDeviceStatusAggregate' | 'getDeviceSettingsContribution' | 'getDeviceLiveContribution' | 'applyDeviceSettingsPatch'>;
     readonly deviceState: Pick<InferDeviceProxyCap<typeof deviceStateCapability>, 'getSnapshot' | 'getCapSlice' | 'setCapSlice'>;
     readonly faceGallery: Pick<InferDeviceProxyCap<typeof faceGalleryCapability>, 'listRecentFaces' | 'getFaceByTrack'>;
     readonly networkQuality: Pick<InferDeviceProxyCap<typeof networkQualityCapability>, 'getDeviceStats' | 'reportClientStats'>;

package/dist/generated/method-access-map.d.ts

@@ -6,7 +6,7 @@
  * scope+access check inside `protectedProcedure` (see
  * `server/backend/src/api/trpc/trpc.middleware.ts`).
  *
- * Coverage: 953 method paths across 123 capabilities.
+ * Coverage: 955 method paths across 123 capabilities.
  */
 import type { CapabilityMethodAccess } from '../capabilities/capability-definition.js';
 export interface MethodAccessRecord {

package/dist/generated/method-device-selectors.d.ts

@@ -6,8 +6,8 @@
  * system-scope cap that takes a deviceId was previously never device-filtered
  * — see the generator header).
  *
- * Coverage: 339 methods carry a device reference, of which
- * 124 are on SYSTEM-scope caps.
+ * Coverage: 342 methods carry a device reference, of which
+ * 127 are on SYSTEM-scope caps.
  *
  * Top-level fields, number arrays, and one-level arrays of objects carrying
  * a numeric device field (targets[].deviceId) are all mapped; the matcher

package/dist/generated/system-proxy.d.ts

@@ -68,7 +68,7 @@ export interface SystemProxy {
     readonly decoder: Pick<InferProvider<typeof decoderCapability>, 'supportsCodec' | 'getInfo' | 'createSession' | 'destroySession' | 'pushPacket' | 'openStream' | 'pullFrames' | 'pullHandles' | 'getFrame' | 'getShmStats' | 'updateConfig' | 'getStats' | 'listActiveSessions' | 'reprobeHwaccel'>;
     readonly deviceAdoption: Pick<InferProvider<typeof deviceAdoptionCapability>, 'listCandidateFilters' | 'listCandidates' | 'getCandidate' | 'refresh' | 'adopt' | 'release' | 'resync'>;
     readonly deviceExport: Pick<InferProvider<typeof deviceExportCapability>, 'getStatus' | 'listSupportedDeviceKinds' | 'listExposedDevices' | 'exposeDevice' | 'unexposeDevice'>;
-    readonly deviceManager: Pick<InferProvider<typeof deviceManagerCapability>, 'allocateDeviceId' | 'registerDevice' | 'removeDevice' | 'persistConfig' | 'getRoleDisplayDefaults' | 'setRoleDisplayDefaults' | 'listLocations' | 'addLocation' | 'removeLocation' | 'listPersistedByAddon' | 'listAll' | 'getChildren' | 'removeByIntegration' | 'listWrappersForCap' | 'listBindableCapsForDeviceType' | 'discoverDevices' | 'adoptDevice' | 'getCreationSchema' | 'createDevice' | 'testCreationField' | 'adoptionListCandidateFilters' | 'adoptionListCandidates' | 'adoptionRefresh' | 'adoptionAdopt' | 'adoptionRelease' | 'adoptionStartJob' | 'adoptionListJobs' | 'adoptionCancelJob' | 'adoptionResync' | 'discoveryProviders' | 'discoverAllProviders' | 'discoverProvider' | 'providerCreationType' | 'providerDiscoveryParamsSchema' | 'getDeviceStatusAggregateBatch'>;
+    readonly deviceManager: Pick<InferProvider<typeof deviceManagerCapability>, 'allocateDeviceId' | 'registerDevice' | 'removeDevice' | 'persistConfig' | 'getRoleDisplayDefaults' | 'setRoleDisplayDefaults' | 'listLocations' | 'addLocation' | 'removeLocation' | 'listPersistedByAddon' | 'listAll' | 'getChildren' | 'getLinkedDevicesBatch' | 'removeByIntegration' | 'getBindingsBatch' | 'getAllBindings' | 'listWrappersForCap' | 'listBindableCapsForDeviceType' | 'discoverDevices' | 'adoptDevice' | 'getCreationSchema' | 'createDevice' | 'testCreationField' | 'adoptionListCandidateFilters' | 'adoptionListCandidates' | 'adoptionRefresh' | 'adoptionAdopt' | 'adoptionRelease' | 'adoptionStartJob' | 'adoptionListJobs' | 'adoptionCancelJob' | 'adoptionResync' | 'discoveryProviders' | 'discoverAllProviders' | 'discoverProvider' | 'providerCreationType' | 'providerDiscoveryParamsSchema' | 'getDeviceStatusAggregateBatch'>;
     readonly deviceProvider: Pick<InferProvider<typeof deviceProviderCapability>, 'start' | 'stop' | 'getStatus' | 'getDevices' | 'supportsDiscovery' | 'discoverDevices' | 'getDiscoveryParamsSchema' | 'getManualCreationType' | 'adoptDiscoveredDevice' | 'supportsManualCreation' | 'getChildCreationSchema' | 'createDevice' | 'testCreationField'>;
     readonly deviceState: Pick<InferProvider<typeof deviceStateCapability>, 'getAllSnapshots'>;
     readonly faceGallery: Pick<InferProvider<typeof faceGalleryCapability>, 'listIdentities' | 'createIdentity' | 'renameIdentity' | 'deleteIdentity' | 'listIdentitySamples' | 'removeSample' | 'getFaceMedia' | 'assignFace' | 'unassignFace' | 'deleteFace' | 'assignFaces' | 'unassignFaces' | 'suggestFaceClusters'>;

package/dist/index.js

@@ -1,6 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_event_category = require("./event-category-EY0GNjV9.js");
-const require_sleep = require("./sleep-CizGYrCD.js");
+const require_sleep = require("./sleep-CUuoW-kk.js");
 const require_canonical_hash = require("./canonical-hash-DNV8S5ET.js");
 const require_enums = require("./enums.js");
 const require_err_msg = require("./err-msg-COpsHMw2.js");
@@ -8598,6 +8598,27 @@ var LinkedDeviceSchema = zod.z.object({
 	features: zod.z.array(zod.z.string()),
 	producesTrackedEvents: zod.z.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 = zod.z.object({
+	deviceId: zod.z.number(),
+	mode: LinkedDevicesModeSchema,
+	devices: zod.z.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 = zod.z.object({
+	deviceId: zod.z.number(),
+	entries: zod.z.array(zod.z.object({
+		capName: zod.z.string(),
+		kind: zod.z.enum(["native", "wrapped"]),
+		providerAddonId: zod.z.string(),
+		providerNodeId: zod.z.string(),
+		nativeAddonId: zod.z.string()
+	}))
+});
 var SavedDeviceRowSchema = zod.z.object({
 	/** Numeric id reserved at allocateDeviceId time. */
 	id: zod.z.number(),
@@ -8960,7 +8981,21 @@ var deviceManagerCapability = {
 			projection: zod.z.enum(["full", "slim"]).optional(),
 			/** Return only camera devices. Filtering server-side instead of
 			*  shipping 293 rows to find 12. */
-			isCamera: zod.z.boolean().optional()
+			isCamera: zod.z.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: zod.z.array(zod.z.number()).optional()
 		}), zod.z.array(DeviceInfoSchema)),
 		/** Get a single device by numeric deviceId. */
 		getDevice: require_sleep.method(zod.z.object({ deviceId: zod.z.number() }), DeviceInfoSchema.nullable()),
@@ -8979,6 +9014,23 @@ var deviceManagerCapability = {
 			mode: LinkedDevicesModeSchema,
 			devices: zod.z.array(LinkedDeviceSchema)
 		})),
+		/**
+		* `getLinkedDevices` for MANY cameras, in one call.
+		*
+		* Not a convenience wrapper — a cost fix. Resolving one camera's linked set
+		* needs the whole fleet as candidates (children ∪ same-location), so the
+		* single-device path runs a full `listAll` per call. Asked per camera that
+		* is N full-fleet sweeps of device-manager's event loop, and they do not
+		* overlap: measured on the live hub 2026-08-25, 30 concurrent
+		* `getLinkedDevices` took 4110 ms wall (median 4060 ms each) to return
+		* 7260 bytes in total. The batch takes ONE sweep and one settings read per
+		* camera.
+		*
+		* A device id that resolves to nothing still gets a row (`devices: []`) —
+		* a caller that asked for thirty and got twenty-eight cannot tell which two
+		* are missing, or that any are.
+		*/
+		getLinkedDevicesBatch: require_sleep.method(zod.z.object({ deviceIds: zod.z.array(zod.z.number()) }), zod.z.array(LinkedDevicesForDeviceSchema)),
 		/** Get stream sources for a camera device. */
 		getStreamSources: require_sleep.method(zod.z.object({ deviceId: zod.z.number() }), zod.z.array(require_sleep.StreamSourceEntrySchema)),
 		/** Get config entries (key + value + description) for a device. */
@@ -9036,16 +9088,22 @@ var deviceManagerCapability = {
 		* currently-active provider (native or wrapper) + the underlying native
 		* addon id, so consumers can decide routing without re-running discovery.
 		*/
-		getBindings: require_sleep.method(zod.z.object({ deviceId: zod.z.number() }), zod.z.object({
-			deviceId: zod.z.number(),
-			entries: zod.z.array(zod.z.object({
-				capName: zod.z.string(),
-				kind: zod.z.enum(["native", "wrapped"]),
-				providerAddonId: zod.z.string(),
-				providerNodeId: zod.z.string(),
-				nativeAddonId: zod.z.string()
-			}))
-		})),
+		getBindings: require_sleep.method(zod.z.object({ deviceId: zod.z.number() }), DeviceBindingsForDeviceSchema),
+		/**
+		* `getBindings` for a NAMED set of devices, in one call.
+		*
+		* Between `getBindings` (one device) and `getAllBindings` (all 988) there
+		* was nothing, so a caller that needs seventy-five either pays
+		* seventy-five round-trips or drags the whole fleet across. Measured on
+		* the live hub 2026-08-25: 75 concurrent `getBindings` = 1211 ms / 118 KB,
+		* `getAllBindings({})` = 511 ms / 679 KB. Neither is the right answer to
+		* "these seventy-five".
+		*
+		* Same resolver, same routing rules, same per-device shape as
+		* `getBindings`; ids are deduped and a device with no bindings answers
+		* `entries: []` rather than dropping out.
+		*/
+		getBindingsBatch: require_sleep.method(zod.z.object({ deviceIds: zod.z.array(zod.z.number()) }), zod.z.array(DeviceBindingsForDeviceSchema)),
 		/**
 		* Return the binding map for every device known to the hub. Used by
 		* `SystemManager` warm-boot: a single round-trip resolves the
@@ -9054,16 +9112,7 @@ var deviceManagerCapability = {
 		* device add/remove) — clients invalidate via the
 		* `capability.binding-changed` event.
 		*/
-		getAllBindings: require_sleep.method(zod.z.object({}), zod.z.array(zod.z.object({
-			deviceId: zod.z.number(),
-			entries: zod.z.array(zod.z.object({
-				capName: zod.z.string(),
-				kind: zod.z.enum(["native", "wrapped"]),
-				providerAddonId: zod.z.string(),
-				providerNodeId: zod.z.string(),
-				nativeAddonId: zod.z.string()
-			}))
-		}))),
+		getAllBindings: require_sleep.method(zod.z.object({}), zod.z.array(DeviceBindingsForDeviceSchema)),
 		/**
 		* Activate (or deactivate) a wrapper addon for a (device, cap) pair.
 		* Persists the binding via ctx.settings. active=false clears the wrapper
@@ -36048,6 +36097,12 @@ var METHOD_ACCESS_MAP = Object.freeze({
 		addonId: null,
 		access: "view"
 	},
+	"deviceManager.getBindingsBatch": {
+		capName: "device-manager",
+		capScope: "system",
+		addonId: null,
+		access: "view"
+	},
 	"deviceManager.getChildren": {
 		capName: "device-manager",
 		capScope: "system",
@@ -36108,6 +36163,12 @@ var METHOD_ACCESS_MAP = Object.freeze({
 		addonId: null,
 		access: "view"
 	},
+	"deviceManager.getLinkedDevicesBatch": {
+		capName: "device-manager",
+		capScope: "system",
+		addonId: null,
+		access: "view"
+	},
 	"deviceManager.getRoleDisplayDefaults": {
 		capName: "device-manager",
 		capScope: "system",
@@ -41012,6 +41073,11 @@ var METHOD_DEVICE_SELECTORS = Object.freeze({
 		form: "single",
 		optional: false
 	}],
+	"deviceManager.getBindingsBatch": [{
+		name: "deviceIds",
+		form: "array",
+		optional: false
+	}],
 	"deviceManager.getChildren": [{
 		name: "parentDeviceId",
 		form: "single",
@@ -41057,6 +41123,11 @@ var METHOD_DEVICE_SELECTORS = Object.freeze({
 		form: "single",
 		optional: false
 	}],
+	"deviceManager.getLinkedDevicesBatch": [{
+		name: "deviceIds",
+		form: "array",
+		optional: false
+	}],
 	"deviceManager.getSettingsSchema": [{
 		name: "deviceId",
 		form: "single",
@@ -41077,6 +41148,11 @@ var METHOD_DEVICE_SELECTORS = Object.freeze({
 		form: "single",
 		optional: false
 	}],
+	"deviceManager.listAll": [{
+		name: "deviceIds",
+		form: "array",
+		optional: true
+	}],
 	"deviceManager.loadConfig": [{
 		name: "deviceId",
 		form: "single",
@@ -42467,6 +42543,7 @@ var SYSTEM_SCOPE_DEVICE_METHODS = [
 	"deviceManager.disable",
 	"deviceManager.enable",
 	"deviceManager.getBindings",
+	"deviceManager.getBindingsBatch",
 	"deviceManager.getChildren",
 	"deviceManager.getConfigSchema",
 	"deviceManager.getDevice",
@@ -42476,10 +42553,12 @@ var SYSTEM_SCOPE_DEVICE_METHODS = [
 	"deviceManager.getDeviceStatusAggregate",
 	"deviceManager.getDeviceStatusAggregateBatch",
 	"deviceManager.getLinkedDevices",
+	"deviceManager.getLinkedDevicesBatch",
 	"deviceManager.getSettingsSchema",
 	"deviceManager.getStreamProfileMap",
 	"deviceManager.getStreamSources",
 	"deviceManager.getWireableFields",
+	"deviceManager.listAll",
 	"deviceManager.loadConfig",
 	"deviceManager.loadMeta",
 	"deviceManager.loadRuntimeState",
@@ -43202,7 +43281,10 @@ function createSystemProxy(api) {
 			listPersistedByAddon: (input) => dispatch("deviceManager", "listPersistedByAddon", "query", input),
 			listAll: (input) => dispatch("deviceManager", "listAll", "query", input),
 			getChildren: (input) => dispatch("deviceManager", "getChildren", "query", input),
+			getLinkedDevicesBatch: (input) => dispatch("deviceManager", "getLinkedDevicesBatch", "query", input),
 			removeByIntegration: (input) => dispatch("deviceManager", "removeByIntegration", "mutation", input),
+			getBindingsBatch: (input) => dispatch("deviceManager", "getBindingsBatch", "query", input),
+			getAllBindings: (input) => dispatch("deviceManager", "getAllBindings", "query", input),
 			listWrappersForCap: (input) => dispatch("deviceManager", "listWrappersForCap", "query", input),
 			listBindableCapsForDeviceType: (input) => dispatch("deviceManager", "listBindableCapsForDeviceType", "query", input),
 			discoverDevices: (input) => dispatch("deviceManager", "discoverDevices", "mutation", input),

package/dist/index.mjs

@@ -1,5 +1,5 @@
 import { t as EventCategory } from "./event-category-CIa_iT6b.mjs";
-import { $ as DecodedFrameSchema, A as event, B as ReadinessRegistry, C as DeviceFeature, Ct as isEvent, D as DEFAULT_RUNTIME_STATE_DURABILITY, Dt as collectHydratedFieldValues, E as adminUiCapability, Et as collectHydratedFieldEntries, F as systemMethod, G as BrokerStatsSchema, H as emitDownForOwnedCaps, I as CAP_NODE_PIN_CONTEXT_KEY, J as CamProfileSchema, K as BrokerStatusSchema, L as nodePin, M as isDeviceConfigCap, N as method, O as DEVICE_SETTINGS_CONTRIBUTION_METHODS, Ot as hydrateSchema, P as resolveCapMount, Q as DecodedAudioChunkSchema, R as readNodePin, S as ChargingStatus, St as emitReadiness, T as DeviceType, Tt as WELL_KNOWN_TAB_MAP, U as readinessKey, V as ReadinessTimeoutError, W as scopeKey, X as CamStreamResolutionSchema, Y as CamStreamKindSchema, Z as CameraStreamSchema, _ as createMirrorSource, _t as DisposerChain, a as asJsonObject, at as ProfileSlotStatusSchema, b as deviceOpsCapability, bt as createDurableState, c as parseJsonArray, ct as SubscribeAudioChunksInputSchema, d as BOOT_RECOVERY_BACKOFF_MS, dt as SubscribeFramesResultSchema, et as EncodedPacketSchema, f as DEVICE_SCOPED_CAPS, ft as makeProfileBrokerId, g as createLazyTrpcSource, gt as DATAPLANE_SECRET_HEADER, h as createEventBusSliceSource, ht as selectAssignedProfileSlots, i as asJsonArray, it as ProfileSlotSchema, j as expandCapMethods, k as DEVICE_STATUS_METHOD, kt as resolveHydratedFieldValue, l as parseJsonObject, lt as SubscribeAudioChunksResultSchema, m as createDeviceProxy, mt as parseProfileBrokerId, n as sleepCancellable, nt as FrameHandleSchema, o as asNumber, ot as StreamSourceEntrySchema, p as isDeviceScopedCap, pt as makeSourceBrokerId, q as CAM_PROFILE_ORDER, r as asBoolean, rt as ProfileRtspEntrySchema, s as asString, st as StreamSourceSchema, t as sleep, tt as FrameHandleFormatSchema, u as parseJsonUnknown, ut as SubscribeFramesInputSchema, v as createSliceHandle, vt as BaseAddon, w as DeviceRole, wt as WELL_KNOWN_TABS, x as viewerUiCapability, xt as createEvent, y as RawStateResultSchema, yt as normalizeAddonInitResult, z as toNodeId } from "./sleep-Cs9MWLcT.mjs";
+import { $ as DecodedFrameSchema, A as event, B as ReadinessRegistry, C as DeviceFeature, Ct as isEvent, D as DEFAULT_RUNTIME_STATE_DURABILITY, Dt as collectHydratedFieldValues, E as adminUiCapability, Et as collectHydratedFieldEntries, F as systemMethod, G as BrokerStatsSchema, H as emitDownForOwnedCaps, I as CAP_NODE_PIN_CONTEXT_KEY, J as CamProfileSchema, K as BrokerStatusSchema, L as nodePin, M as isDeviceConfigCap, N as method, O as DEVICE_SETTINGS_CONTRIBUTION_METHODS, Ot as hydrateSchema, P as resolveCapMount, Q as DecodedAudioChunkSchema, R as readNodePin, S as ChargingStatus, St as emitReadiness, T as DeviceType, Tt as WELL_KNOWN_TAB_MAP, U as readinessKey, V as ReadinessTimeoutError, W as scopeKey, X as CamStreamResolutionSchema, Y as CamStreamKindSchema, Z as CameraStreamSchema, _ as createMirrorSource, _t as DisposerChain, a as asJsonObject, at as ProfileSlotStatusSchema, b as deviceOpsCapability, bt as createDurableState, c as parseJsonArray, ct as SubscribeAudioChunksInputSchema, d as BOOT_RECOVERY_BACKOFF_MS, dt as SubscribeFramesResultSchema, et as EncodedPacketSchema, f as DEVICE_SCOPED_CAPS, ft as makeProfileBrokerId, g as createLazyTrpcSource, gt as DATAPLANE_SECRET_HEADER, h as createEventBusSliceSource, ht as selectAssignedProfileSlots, i as asJsonArray, it as ProfileSlotSchema, j as expandCapMethods, k as DEVICE_STATUS_METHOD, kt as resolveHydratedFieldValue, l as parseJsonObject, lt as SubscribeAudioChunksResultSchema, m as createDeviceProxy, mt as parseProfileBrokerId, n as sleepCancellable, nt as FrameHandleSchema, o as asNumber, ot as StreamSourceEntrySchema, p as isDeviceScopedCap, pt as makeSourceBrokerId, q as CAM_PROFILE_ORDER, r as asBoolean, rt as ProfileRtspEntrySchema, s as asString, st as StreamSourceSchema, t as sleep, tt as FrameHandleFormatSchema, u as parseJsonUnknown, ut as SubscribeFramesInputSchema, v as createSliceHandle, vt as BaseAddon, w as DeviceRole, wt as WELL_KNOWN_TABS, x as viewerUiCapability, xt as createEvent, y as RawStateResultSchema, yt as normalizeAddonInitResult, z as toNodeId } from "./sleep-BLxqGLY0.mjs";
 import { a as buildAudioArgs, c as buildVideoArgs, d as logBannerArgs, f as pickVideoEncoder, i as audioPlanFromEncodeProfile, l as invocationFromEncodeProfile, n as Fmp4BoxSplitter, o as buildFfmpegArgs, r as AUDIO_PRESETS, s as buildInputArgs, t as canonicalHash, u as isSoftwareDecode } from "./canonical-hash-rO1sRmEK.mjs";
 import { EventSourceType } from "./enums.mjs";
 import { t as errMsg } from "./err-msg-IQTHeDzc.mjs";
@@ -8597,6 +8597,27 @@ var LinkedDeviceSchema = z.object({
 	features: z.array(z.string()),
 	producesTrackedEvents: z.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 = z.object({
+	deviceId: z.number(),
+	mode: LinkedDevicesModeSchema,
+	devices: z.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 = z.object({
+	deviceId: z.number(),
+	entries: z.array(z.object({
+		capName: z.string(),
+		kind: z.enum(["native", "wrapped"]),
+		providerAddonId: z.string(),
+		providerNodeId: z.string(),
+		nativeAddonId: z.string()
+	}))
+});
 var SavedDeviceRowSchema = z.object({
 	/** Numeric id reserved at allocateDeviceId time. */
 	id: z.number(),
@@ -8959,7 +8980,21 @@ var deviceManagerCapability = {
 			projection: z.enum(["full", "slim"]).optional(),
 			/** Return only camera devices. Filtering server-side instead of
 			*  shipping 293 rows to find 12. */
-			isCamera: z.boolean().optional()
+			isCamera: z.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: z.array(z.number()).optional()
 		}), z.array(DeviceInfoSchema)),
 		/** Get a single device by numeric deviceId. */
 		getDevice: method(z.object({ deviceId: z.number() }), DeviceInfoSchema.nullable()),
@@ -8978,6 +9013,23 @@ var deviceManagerCapability = {
 			mode: LinkedDevicesModeSchema,
 			devices: z.array(LinkedDeviceSchema)
 		})),
+		/**
+		* `getLinkedDevices` for MANY cameras, in one call.
+		*
+		* Not a convenience wrapper — a cost fix. Resolving one camera's linked set
+		* needs the whole fleet as candidates (children ∪ same-location), so the
+		* single-device path runs a full `listAll` per call. Asked per camera that
+		* is N full-fleet sweeps of device-manager's event loop, and they do not
+		* overlap: measured on the live hub 2026-08-25, 30 concurrent
+		* `getLinkedDevices` took 4110 ms wall (median 4060 ms each) to return
+		* 7260 bytes in total. The batch takes ONE sweep and one settings read per
+		* camera.
+		*
+		* A device id that resolves to nothing still gets a row (`devices: []`) —
+		* a caller that asked for thirty and got twenty-eight cannot tell which two
+		* are missing, or that any are.
+		*/
+		getLinkedDevicesBatch: method(z.object({ deviceIds: z.array(z.number()) }), z.array(LinkedDevicesForDeviceSchema)),
 		/** Get stream sources for a camera device. */
 		getStreamSources: method(z.object({ deviceId: z.number() }), z.array(StreamSourceEntrySchema)),
 		/** Get config entries (key + value + description) for a device. */
@@ -9035,16 +9087,22 @@ var deviceManagerCapability = {
 		* currently-active provider (native or wrapper) + the underlying native
 		* addon id, so consumers can decide routing without re-running discovery.
 		*/
-		getBindings: method(z.object({ deviceId: z.number() }), z.object({
-			deviceId: z.number(),
-			entries: z.array(z.object({
-				capName: z.string(),
-				kind: z.enum(["native", "wrapped"]),
-				providerAddonId: z.string(),
-				providerNodeId: z.string(),
-				nativeAddonId: z.string()
-			}))
-		})),
+		getBindings: method(z.object({ deviceId: z.number() }), DeviceBindingsForDeviceSchema),
+		/**
+		* `getBindings` for a NAMED set of devices, in one call.
+		*
+		* Between `getBindings` (one device) and `getAllBindings` (all 988) there
+		* was nothing, so a caller that needs seventy-five either pays
+		* seventy-five round-trips or drags the whole fleet across. Measured on
+		* the live hub 2026-08-25: 75 concurrent `getBindings` = 1211 ms / 118 KB,
+		* `getAllBindings({})` = 511 ms / 679 KB. Neither is the right answer to
+		* "these seventy-five".
+		*
+		* Same resolver, same routing rules, same per-device shape as
+		* `getBindings`; ids are deduped and a device with no bindings answers
+		* `entries: []` rather than dropping out.
+		*/
+		getBindingsBatch: method(z.object({ deviceIds: z.array(z.number()) }), z.array(DeviceBindingsForDeviceSchema)),
 		/**
 		* Return the binding map for every device known to the hub. Used by
 		* `SystemManager` warm-boot: a single round-trip resolves the
@@ -9053,16 +9111,7 @@ var deviceManagerCapability = {
 		* device add/remove) — clients invalidate via the
 		* `capability.binding-changed` event.
 		*/
-		getAllBindings: method(z.object({}), z.array(z.object({
-			deviceId: z.number(),
-			entries: z.array(z.object({
-				capName: z.string(),
-				kind: z.enum(["native", "wrapped"]),
-				providerAddonId: z.string(),
-				providerNodeId: z.string(),
-				nativeAddonId: z.string()
-			}))
-		}))),
+		getAllBindings: method(z.object({}), z.array(DeviceBindingsForDeviceSchema)),
 		/**
 		* Activate (or deactivate) a wrapper addon for a (device, cap) pair.
 		* Persists the binding via ctx.settings. active=false clears the wrapper
@@ -36040,6 +36089,12 @@ var METHOD_ACCESS_MAP = Object.freeze({
 		addonId: null,
 		access: "view"
 	},
+	"deviceManager.getBindingsBatch": {
+		capName: "device-manager",
+		capScope: "system",
+		addonId: null,
+		access: "view"
+	},
 	"deviceManager.getChildren": {
 		capName: "device-manager",
 		capScope: "system",
@@ -36100,6 +36155,12 @@ var METHOD_ACCESS_MAP = Object.freeze({
 		addonId: null,
 		access: "view"
 	},
+	"deviceManager.getLinkedDevicesBatch": {
+		capName: "device-manager",
+		capScope: "system",
+		addonId: null,
+		access: "view"
+	},
 	"deviceManager.getRoleDisplayDefaults": {
 		capName: "device-manager",
 		capScope: "system",
@@ -41004,6 +41065,11 @@ var METHOD_DEVICE_SELECTORS = Object.freeze({
 		form: "single",
 		optional: false
 	}],
+	"deviceManager.getBindingsBatch": [{
+		name: "deviceIds",
+		form: "array",
+		optional: false
+	}],
 	"deviceManager.getChildren": [{
 		name: "parentDeviceId",
 		form: "single",
@@ -41049,6 +41115,11 @@ var METHOD_DEVICE_SELECTORS = Object.freeze({
 		form: "single",
 		optional: false
 	}],
+	"deviceManager.getLinkedDevicesBatch": [{
+		name: "deviceIds",
+		form: "array",
+		optional: false
+	}],
 	"deviceManager.getSettingsSchema": [{
 		name: "deviceId",
 		form: "single",
@@ -41069,6 +41140,11 @@ var METHOD_DEVICE_SELECTORS = Object.freeze({
 		form: "single",
 		optional: false
 	}],
+	"deviceManager.listAll": [{
+		name: "deviceIds",
+		form: "array",
+		optional: true
+	}],
 	"deviceManager.loadConfig": [{
 		name: "deviceId",
 		form: "single",
@@ -42459,6 +42535,7 @@ var SYSTEM_SCOPE_DEVICE_METHODS = [
 	"deviceManager.disable",
 	"deviceManager.enable",
 	"deviceManager.getBindings",
+	"deviceManager.getBindingsBatch",
 	"deviceManager.getChildren",
 	"deviceManager.getConfigSchema",
 	"deviceManager.getDevice",
@@ -42468,10 +42545,12 @@ var SYSTEM_SCOPE_DEVICE_METHODS = [
 	"deviceManager.getDeviceStatusAggregate",
 	"deviceManager.getDeviceStatusAggregateBatch",
 	"deviceManager.getLinkedDevices",
+	"deviceManager.getLinkedDevicesBatch",
 	"deviceManager.getSettingsSchema",
 	"deviceManager.getStreamProfileMap",
 	"deviceManager.getStreamSources",
 	"deviceManager.getWireableFields",
+	"deviceManager.listAll",
 	"deviceManager.loadConfig",
 	"deviceManager.loadMeta",
 	"deviceManager.loadRuntimeState",
@@ -43194,7 +43273,10 @@ function createSystemProxy(api) {
 			listPersistedByAddon: (input) => dispatch("deviceManager", "listPersistedByAddon", "query", input),
 			listAll: (input) => dispatch("deviceManager", "listAll", "query", input),
 			getChildren: (input) => dispatch("deviceManager", "getChildren", "query", input),
+			getLinkedDevicesBatch: (input) => dispatch("deviceManager", "getLinkedDevicesBatch", "query", input),
 			removeByIntegration: (input) => dispatch("deviceManager", "removeByIntegration", "mutation", input),
+			getBindingsBatch: (input) => dispatch("deviceManager", "getBindingsBatch", "query", input),
+			getAllBindings: (input) => dispatch("deviceManager", "getAllBindings", "query", input),
 			listWrappersForCap: (input) => dispatch("deviceManager", "listWrappersForCap", "query", input),
 			listBindableCapsForDeviceType: (input) => dispatch("deviceManager", "listBindableCapsForDeviceType", "query", input),
 			discoverDevices: (input) => dispatch("deviceManager", "discoverDevices", "mutation", input),

package/dist/{sleep-Cs9MWLcT.mjs → sleep-BLxqGLY0.mjs}

@@ -3501,7 +3501,6 @@ function createDeviceProxy(api, binding, opts) {
 			setStreamProfileMap: (input) => dispatchSystem("deviceManager", "setStreamProfileMap", "mutation", input),
 			probeStreams: (input) => dispatchSystem("deviceManager", "probeStreams", "mutation", input),
 			getBindings: (input) => dispatchSystem("deviceManager", "getBindings", "query", input),
-			getAllBindings: (input) => dispatchSystem("deviceManager", "getAllBindings", "query", input),
 			setWrapperActive: (input) => dispatchSystem("deviceManager", "setWrapperActive", "mutation", input),
 			getDeviceSettingsAggregate: (input) => dispatchSystem("deviceManager", "getDeviceSettingsAggregate", "query", input),
 			getDeviceLiveInfoAggregate: (input) => dispatchSystem("deviceManager", "getDeviceLiveInfoAggregate", "query", input),

package/dist/{sleep-CizGYrCD.js → sleep-CUuoW-kk.js}

@@ -3501,7 +3501,6 @@ function createDeviceProxy(api, binding, opts) {
 			setStreamProfileMap: (input) => dispatchSystem("deviceManager", "setStreamProfileMap", "mutation", input),
 			probeStreams: (input) => dispatchSystem("deviceManager", "probeStreams", "mutation", input),
 			getBindings: (input) => dispatchSystem("deviceManager", "getBindings", "query", input),
-			getAllBindings: (input) => dispatchSystem("deviceManager", "getAllBindings", "query", input),
 			setWrapperActive: (input) => dispatchSystem("deviceManager", "setWrapperActive", "mutation", input),
 			getDeviceSettingsAggregate: (input) => dispatchSystem("deviceManager", "getDeviceSettingsAggregate", "query", input),
 			getDeviceLiveInfoAggregate: (input) => dispatchSystem("deviceManager", "getDeviceLiveInfoAggregate", "query", input),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@camstack/types",
-  "version": "1.2.103",
+  "version": "1.2.104",
   "description": "Shared types, interfaces, and model catalogs for the CamStack detection ecosystem",
   "keywords": [
     "camstack",