@camstack/types 1.2.242 → 1.2.244

package/dist/capabilities/videoclips.cap.d.ts

@@ -95,6 +95,15 @@ export declare const CLIP_STILL_REASON_HEADER = "x-camstack-reason";
 export declare const CLIP_STILL_REASON_CODE_HEADER = "x-camstack-reason-code";
 /** One {@link ClipStillDispositionSchema} token, alone. */
 export declare const CLIP_STILL_DISPOSITION_HEADER = "x-camstack-disposition";
+/**
+ * The clip STREAM route's own statement of what it is (D597): the value is
+ * `forward-only`. A producer writes it on the 200; a consumer that dials a
+ * URL and does not read it back refuses to play, because a progressive file
+ * through a forward-only feeder looks like it worked until the first seek.
+ * Named here because BOTH the provider and the broker spell it, and two
+ * copies of a header name is how one of them stops being checked.
+ */
+export declare const CLIP_STREAM_TRANSPORT_HEADER = "x-camstack-clip-transport";
 export declare const ClipSchema: z.ZodObject<{
     id: z.ZodString;
     source: z.ZodString;
@@ -239,6 +248,71 @@ export declare const ClipBytesSchema: z.ZodObject<{
     durationMs: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strip>;
 export type ClipBytes = z.infer<typeof ClipBytesSchema>;
+/**
+ * Where a clip's STREAM can be dialled (D597) — the answer to
+ * {@link videoclipsCapability.methods.dialClipStream}.
+ *
+ * `url` is plain `http://` on the provider's own token-gated listener, one
+ * shot, short-lived. It is NOT the hub-proxied `/addon/<id>/clip-stream/…`
+ * path: that plane takes only a user credential, which an addon does not
+ * hold, and the framework offers no addon→addon byte transport — the one
+ * precedent is the broker's own restream URLs (`getStreamWithCodec`), which
+ * a consumer dials directly, and this is that precedent one addon over.
+ */
+/**
+ * The audio a clip stream can be asked for, and the audio it carries.
+ *
+ * The camera stores AAC and no WebRTC session speaks it, so a stream that
+ * carries sound carries it TRANSCODED, muxed as a second track beside the
+ * video by the one ffmpeg the provider already runs (D600). `opus` is
+ * 48 kHz mono, `pcmu` is 8 kHz µ-law — the two codecs a broker session
+ * negotiates — and `none` is a stream asked for, or served, without sound.
+ */
+export declare const ClipStreamAudioSchema: z.ZodEnum<{
+    pcmu: "pcmu";
+    none: "none";
+    opus: "opus";
+}>;
+export type ClipStreamAudio = z.infer<typeof ClipStreamAudioSchema>;
+/**
+ * Why a stream that was ASKED for sound is not carrying it (D600).
+ *
+ * Only ever set beside `servedAudio: 'none'` after a non-`none` ask. Absent
+ * means the ask was honoured, or there was no ask.
+ *
+ * - `not-requested` — the caller asked for `none`.
+ * - `unsupported-ask` — the provider cannot produce that codec.
+ *
+ * Whether the RECORDING has sound at all is not knowable here: the camera
+ * declares no audio track before its first frame arrives. That answer is in
+ * the stream itself — an fMP4 with no audio track — and the broker reads it
+ * there. A dial that says `opus` promises the codec, never the content.
+ */
+export declare const ClipStreamAudioReasonSchema: z.ZodEnum<{
+    "not-requested": "not-requested";
+    "unsupported-ask": "unsupported-ask";
+}>;
+export type ClipStreamAudioReason = z.infer<typeof ClipStreamAudioReasonSchema>;
+export declare const ClipStreamDialSchema: z.ZodObject<{
+    url: z.ZodString;
+    expiresAtMs: z.ZodNumber;
+    transport: z.ZodLiteral<"forward-only">;
+    served: z.ZodEnum<{
+        high: "high";
+        mid: "mid";
+        low: "low";
+    }>;
+    servedAudio: z.ZodEnum<{
+        pcmu: "pcmu";
+        none: "none";
+        opus: "opus";
+    }>;
+    audioReason: z.ZodOptional<z.ZodEnum<{
+        "not-requested": "not-requested";
+        "unsupported-ask": "unsupported-ask";
+    }>>;
+}, z.core.$strip>;
+export type ClipStreamDial = z.infer<typeof ClipStreamDialSchema>;
 export declare const ClipSourceAvailabilitySchema: z.ZodObject<{
     state: z.ZodEnum<{
         ok: "ok";
@@ -489,6 +563,57 @@ export declare const videoclipsCapability: {
         }, z.core.$strip>, "query"> & {
             readonly providerOptional: true;
         };
+        /**
+         * Where this clip's STREAM can be dialled (D597) — the forward-only
+         * fMP4 the provider writes from the first muxed byte, for the broker to
+         * play through the same WebRTC session as recorded footage, with the
+         * first frame at the first fragment instead of after the last byte.
+         *
+         * Nothing is fetched here: the answer is a one-shot URL on the
+         * provider's own listener, and the camera is touched when it is dialled.
+         * The gates the file path runs (`readClipBytes`) run on the dial too —
+         * the id, the row, a clip still being written — and refuse in the same
+         * vocabulary, THROWN with `clipExportFailure(<token>, <prose>)`. Every
+         * profile is served (D599) and the answer states which twin it carries;
+         * `high` is not refused. Optional on the provider for the same reason
+         * `readClipBytes` is: a source with no camera socket behind it (the
+         * recorder's analytics window, a HomeKit tee) has no stream.
+         */
+        readonly dialClipStream: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
+            deviceId: z.ZodNumber;
+            clipId: z.ZodString;
+            provider: z.ZodString;
+            profile: z.ZodOptional<z.ZodEnum<{
+                high: "high";
+                mid: "mid";
+                low: "low";
+            }>>;
+            audio: z.ZodOptional<z.ZodEnum<{
+                pcmu: "pcmu";
+                none: "none";
+                opus: "opus";
+            }>>;
+        }, z.core.$strip>, z.ZodObject<{
+            url: z.ZodString;
+            expiresAtMs: z.ZodNumber;
+            transport: z.ZodLiteral<"forward-only">;
+            served: z.ZodEnum<{
+                high: "high";
+                mid: "mid";
+                low: "low";
+            }>;
+            servedAudio: z.ZodEnum<{
+                pcmu: "pcmu";
+                none: "none";
+                opus: "opus";
+            }>;
+            audioReason: z.ZodOptional<z.ZodEnum<{
+                "not-requested": "not-requested";
+                "unsupported-ask": "unsupported-ask";
+            }>>;
+        }, z.core.$strip>, "query"> & {
+            readonly providerOptional: true;
+        };
     };
 };
 export type IVideoclipsProvider = InferProvider<typeof videoclipsCapability>;

package/dist/device/display-icon-vocabulary.d.ts

@@ -0,0 +1,106 @@
+/**
+ * display-icon-vocabulary — the icon KEYS both UIs share, and the search that
+ * finds one.
+ *
+ * The reason this is here and not in a UI package is the one
+ * `location-icon.ts` already states for the location vocabulary: two surfaces
+ * draw these icons and they do NOT share an icon module. The admin UI imports
+ * `lucide-react`; the viewer imports a hand-maintained per-icon allowlist
+ * (`src/lib/icons.ts`, re-exporting `lucide-react-native/icons/*` because the
+ * barrel is 47 % of that app's modules). Anything shared between them must
+ * therefore be STRINGS, and this module contains no React, no lucide, and no
+ * glyph.
+ *
+ * So the layering is:
+ *
+ * | layer | lives in | holds |
+ * | --- | --- | --- |
+ * | vocabulary + search | here | keys, groups, synonyms, scoring |
+ * | glyph table (web) | `ui-library`'s `DISPLAY_ICON_REGISTRY` | key → lucide-react |
+ * | glyph table (phone) | viewer's accessory icon map | key → lucide-react-native |
+ *
+ * Each glyph table must cover exactly these keys, and a test on each side
+ * pins that. A key offered on one surface and missing on the other falls
+ * through to the next precedence level there, which the operator reads as "my
+ * change did nothing" — the failure this vocabulary exists to make impossible.
+ *
+ * {@link LOCATION_ICON_IDS} is a SUBSET of these keys, pinned by a test. Two
+ * icon vocabularies on the same two surfaces with different members is the
+ * same bug wearing a different name — `briefcase` and `route` are here only
+ * because locations already draw them.
+ *
+ * ## Synonyms, and why they are bilingual
+ *
+ * The keys are English lucide ids and always will be: they name the DRAWING,
+ * mechanically checkable against a package, not the room. But the operator
+ * searching this list types Italian — "tapparella", not "blinds". A picker
+ * whose search only matches the key would make three quarters of the
+ * vocabulary unreachable to them.
+ *
+ * So every entry carries the words it answers to, in both languages. They are
+ * deliberately not translations of a label: they are the words somebody would
+ * actually type looking for that picture, including the wrong-but-obvious
+ * ones (`blinds` answers to `persiana` and `serranda` too).
+ */
+/** What an operator is naming when they pick from this group. */
+export type DisplayIconGroup = 'device' | 'lighting' | 'sensing' | 'place' | 'life';
+/** The order the groups are offered in, and the only members there are. */
+export declare const DISPLAY_ICON_GROUPS: readonly DisplayIconGroup[];
+/** One icon in the shared vocabulary. */
+export interface DisplayIconEntry {
+    /** The kebab-case lucide id. This is the value that is PERSISTED. */
+    readonly key: string;
+    readonly group: DisplayIconGroup;
+    /**
+     * Words this icon answers to in search, English and Italian. Never
+     * rendered — a caller that wants a label supplies its own translation.
+     */
+    readonly synonyms: readonly string[];
+    /**
+     * The key this one is a deprecated spelling OF, drawing the same picture.
+     *
+     * An alias must keep RESOLVING — rows have it persisted — but it must not
+     * be OFFERED: a second, identical tile lets an operator newly choose the
+     * spelling we are trying to retire, and gives them no way to tell the two
+     * apart. So `searchDisplayIcons` skips aliases and `displayIconEntry` does
+     * not.
+     */
+    readonly aliasOf?: string;
+}
+/**
+ * The vocabulary, in the order a picker offers it.
+ *
+ * Adding a key here is not enough to make it pickable: both glyph tables must
+ * gain it too, and their tests fail until they do. That is the intended
+ * friction — it is the only thing that keeps the two surfaces honest.
+ */
+export declare const DISPLAY_ICON_VOCABULARY: readonly DisplayIconEntry[];
+/** Every key, in vocabulary order — aliases included, because they resolve. */
+export declare const DISPLAY_ICON_KEYS: readonly string[];
+/** The keys a picker OFFERS: everything that is not a deprecated spelling. */
+export declare const DISPLAY_ICON_OFFERED_KEYS: readonly string[];
+/** Is this a key of the shared vocabulary? */
+export declare function isDisplayIconKey(value: unknown): boolean;
+/** The entry for a key, or `undefined` — never a guessed one. */
+export declare function displayIconEntry(key: string): DisplayIconEntry | undefined;
+/** The entries of one group, in vocabulary order. */
+export declare function displayIconsInGroup(group: DisplayIconGroup): readonly DisplayIconEntry[];
+/** One search result: the entry, and how strongly it matched. */
+export interface DisplayIconHit {
+    readonly entry: DisplayIconEntry;
+    readonly score: number;
+}
+/**
+ * Rank the vocabulary against a free-text query.
+ *
+ * An empty query returns the WHOLE vocabulary in its declared order, because
+ * a picker's resting state is the full list, not an empty one.
+ *
+ * `extraWords` lets a caller add the words IT can translate — a localised
+ * device-role label, say — without this module knowing what a locale is.
+ * They score exactly like a synonym.
+ *
+ * Ties keep vocabulary order: a search that reshuffles equally-good results
+ * between two keystrokes makes the list unusable.
+ */
+export declare function searchDisplayIcons(query: string, extraWords?: ReadonlyMap<string, readonly string[]>): readonly DisplayIconHit[];

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

@@ -36,6 +36,7 @@ import type { customModelRegistryCapability } from '../capabilities/custom-model
 import type { dataStoreProviderCapability } from '../capabilities/data-store-provider.cap.js';
 import type { dayNightCapability } from '../capabilities/day-night.cap.js';
 import type { decoderCapability } from '../capabilities/decoder.cap.js';
+import type { deviceAdminLinkCapability } from '../capabilities/device-admin-link.cap.js';
 import type { deviceAdoptionCapability } from '../capabilities/device-adoption.cap.js';
 import type { deviceDiscoveryCapability } from '../capabilities/device-discovery.cap.js';
 import type { deviceExportCapability } from '../capabilities/device-export.cap.js';
@@ -94,6 +95,7 @@ import type { ptzAutotrackCapability } from '../capabilities/ptz-autotrack.cap.j
 import type { ptzCapability } from '../capabilities/ptz.cap.js';
 import type { rebootCapability } from '../capabilities/reboot.cap.js';
 import type { recordingExportCapability } from '../capabilities/recording-export.cap.js';
+import type { recordingOnboardCapability } from '../capabilities/recording-onboard.cap.js';
 import type { recordingSignalCapability } from '../capabilities/recording-signal.cap.js';
 import type { recordingCapability } from '../capabilities/recording.cap.js';
 import type { sceneMonitorCapability } from '../capabilities/scene-monitor.cap.js';
@@ -1917,6 +1919,20 @@ export type AppRouter = TrpcCoreRouter<{
             meta: object;
         }>;
     }>>;
+    deviceAdminLink: TRPCBuiltRouter<{
+        ctx: TrpcContext;
+        meta: object;
+        errorShape: AugmentedErrorShape;
+        transformer: true;
+    }, TRPCDecorateCreateRouterOptions<{
+        getAdminLink: TRPCQueryProcedure<{
+            input: {
+                [x: string]: unknown;
+            } & z.input<typeof deviceAdminLinkCapability.methods.getAdminLink.input>;
+            output: z.infer<typeof deviceAdminLinkCapability.methods.getAdminLink.output>;
+            meta: object;
+        }>;
+    }>>;
     deviceAdoption: TRPCBuiltRouter<{
         ctx: TrpcContext;
         meta: object;
@@ -7137,6 +7153,34 @@ export type AppRouter = TrpcCoreRouter<{
             meta: object;
         }>;
     }>>;
+    recordingOnboard: TRPCBuiltRouter<{
+        ctx: TrpcContext;
+        meta: object;
+        errorShape: AugmentedErrorShape;
+        transformer: true;
+    }, TRPCDecorateCreateRouterOptions<{
+        getStatus: TRPCQueryProcedure<{
+            input: {
+                [x: string]: unknown;
+            } & z.input<typeof DEVICE_STATUS_METHOD.getStatus.input>;
+            output: z.infer<typeof DEVICE_STATUS_METHOD.getStatus.output>;
+            meta: object;
+        }>;
+        getOptions: TRPCQueryProcedure<{
+            input: {
+                [x: string]: unknown;
+            } & z.input<typeof recordingOnboardCapability.methods.getOptions.input>;
+            output: z.infer<typeof recordingOnboardCapability.methods.getOptions.output>;
+            meta: object;
+        }>;
+        setSettings: TRPCMutationProcedure<{
+            input: {
+                [x: string]: unknown;
+            } & z.input<typeof recordingOnboardCapability.methods.setSettings.input>;
+            output: z.infer<typeof recordingOnboardCapability.methods.setSettings.output>;
+            meta: object;
+        }>;
+    }>>;
     recordingSignal: TRPCBuiltRouter<{
         ctx: TrpcContext;
         meta: object;
@@ -9087,6 +9131,13 @@ export type AppRouter = TrpcCoreRouter<{
             output: z.infer<typeof videoclipsCapability.methods.readClipBytes.output>;
             meta: object;
         }>;
+        dialClipStream: TRPCQueryProcedure<{
+            input: {
+                [x: string]: unknown;
+            } & z.input<typeof videoclipsCapability.methods.dialClipStream.input>;
+            output: z.infer<typeof videoclipsCapability.methods.dialClipStream.output>;
+            meta: object;
+        }>;
     }>>;
     viewerUi: TRPCBuiltRouter<{
         ctx: TrpcContext;

package/dist/generated/cap-status-types.d.ts

@@ -55,6 +55,7 @@ import type { PrivacyMaskStatusSchema } from '../capabilities/privacy-mask.cap.j
 import type { PtzStatusSchema } from '../capabilities/ptz.cap.js';
 import type { PtzAutotrackStatusSchema } from '../capabilities/ptz-autotrack.cap.js';
 import type { RecordingStatusSchema } from '../capabilities/recording.cap.js';
+import type { RecordingOnboardStatusSchema } from '../capabilities/recording-onboard.cap.js';
 import type { RecordingSignalStatusSchema } from '../capabilities/recording-signal.cap.js';
 import type { SceneMonitorStatusSchema } from '../capabilities/scene-monitor.cap.js';
 import type { ScriptRunnerStatusSchema } from '../capabilities/script-runner.cap.js';
@@ -132,6 +133,7 @@ export type CapStatusTypeMap = {
     readonly 'ptz': z.infer<typeof PtzStatusSchema>;
     readonly 'ptz-autotrack': z.infer<typeof PtzAutotrackStatusSchema>;
     readonly 'recording': z.infer<typeof RecordingStatusSchema>;
+    readonly 'recording-onboard': z.infer<typeof RecordingOnboardStatusSchema>;
     readonly 'recording-signal': z.infer<typeof RecordingSignalStatusSchema>;
     readonly 'scene-monitor': z.infer<typeof SceneMonitorStatusSchema>;
     readonly 'script-runner': z.infer<typeof ScriptRunnerStatusSchema>;
@@ -155,4 +157,4 @@ export type CapNameWithStatus = keyof CapStatusTypeMap;
  * aggregator to enumerate caps whose `status` should be polled +
  * streamed via `subscribeDeviceStatusAggregate`.
  */
-export declare const CAP_NAMES_WITH_STATUS: readonly ["accessories", "air-quality-sensor", "alarm-panel", "ambient-light-sensor", "automation-control", "battery", "binary", "brightness", "broker", "camera-credentials", "carbon-monoxide", "climate-control", "color", "connectivity", "consumables", "contact", "control", "cover", "day-night", "device-adoption", "device-discovery", "device-export", "device-status", "doorbell", "enum-sensor", "event-emitter", "fan-control", "feature-probe", "flood", "gas", "humidifier", "humidity-sensor", "image", "image-settings", "intercom", "lawn-mower-control", "lock-control", "media-player", "motion", "motion-trigger", "motion-zones", "mqtt-broker", "native-object-detection", "navigation", "network-link", "notifier", "numeric-sensor", "osd", "pet-feeder", "power-meter", "presence", "pressure-sensor", "privacy-mask", "ptz", "ptz-autotrack", "recording", "recording-signal", "scene-monitor", "script-runner", "smoke", "snapshot", "stream-params", "switch", "tamper", "temperature-sensor", "update", "vacuum-control", "valve", "vibration", "water-heater", "weather"];
+export declare const CAP_NAMES_WITH_STATUS: readonly ["accessories", "air-quality-sensor", "alarm-panel", "ambient-light-sensor", "automation-control", "battery", "binary", "brightness", "broker", "camera-credentials", "carbon-monoxide", "climate-control", "color", "connectivity", "consumables", "contact", "control", "cover", "day-night", "device-adoption", "device-discovery", "device-export", "device-status", "doorbell", "enum-sensor", "event-emitter", "fan-control", "feature-probe", "flood", "gas", "humidifier", "humidity-sensor", "image", "image-settings", "intercom", "lawn-mower-control", "lock-control", "media-player", "motion", "motion-trigger", "motion-zones", "mqtt-broker", "native-object-detection", "navigation", "network-link", "notifier", "numeric-sensor", "osd", "pet-feeder", "power-meter", "presence", "pressure-sensor", "privacy-mask", "ptz", "ptz-autotrack", "recording", "recording-onboard", "recording-signal", "scene-monitor", "script-runner", "smoke", "snapshot", "stream-params", "switch", "tamper", "temperature-sensor", "update", "vacuum-control", "valve", "vibration", "water-heater", "weather"];

package/dist/generated/capability-router-map.d.ts

@@ -42,6 +42,7 @@ export { dataStoreProviderCapability } from '../capabilities/data-store-provider
 export { dayNightCapability } from '../capabilities/day-night.cap.js';
 export { decoderCapability } from '../capabilities/decoder.cap.js';
 export { detectionPipelineCapability } from '../capabilities/detection-pipeline.cap.js';
+export { deviceAdminLinkCapability } from '../capabilities/device-admin-link.cap.js';
 export { deviceAdoptionCapability } from '../capabilities/device-adoption.cap.js';
 export { deviceDiscoveryCapability } from '../capabilities/device-discovery.cap.js';
 export { deviceExportCapability } from '../capabilities/device-export.cap.js';
@@ -116,6 +117,7 @@ export { ptzAutotrackCapability } from '../capabilities/ptz-autotrack.cap.js';
 export { rebootCapability } from '../capabilities/reboot.cap.js';
 export { recordingCapability } from '../capabilities/recording.cap.js';
 export { recordingExportCapability } from '../capabilities/recording-export.cap.js';
+export { recordingOnboardCapability } from '../capabilities/recording-onboard.cap.js';
 export { recordingSignalCapability } from '../capabilities/recording-signal.cap.js';
 export { sceneMonitorCapability } from '../capabilities/scene-monitor.cap.js';
 export { scriptRunnerCapability } from '../capabilities/script-runner.cap.js';
@@ -201,6 +203,7 @@ export declare const CAPABILITY_NAMES: {
     readonly dayNight: "day-night";
     readonly decoder: "decoder";
     readonly detectionPipeline: "detection-pipeline";
+    readonly deviceAdminLink: "device-admin-link";
     readonly deviceAdoption: "device-adoption";
     readonly deviceDiscovery: "device-discovery";
     readonly deviceExport: "device-export";
@@ -275,6 +278,7 @@ export declare const CAPABILITY_NAMES: {
     readonly reboot: "reboot";
     readonly recording: "recording";
     readonly recordingExport: "recording-export";
+    readonly recordingOnboard: "recording-onboard";
     readonly recordingSignal: "recording-signal";
     readonly sceneMonitor: "scene-monitor";
     readonly scriptRunner: "script-runner";
@@ -373,6 +377,7 @@ export interface CapabilityRouterMap<TRouter = unknown> {
     readonly dayNight: TRouter;
     readonly decoder: TRouter;
     readonly detectionPipeline: TRouter;
+    readonly deviceAdminLink: TRouter;
     readonly deviceAdoption: TRouter;
     readonly deviceDiscovery: TRouter;
     readonly deviceExport: TRouter;
@@ -447,6 +452,7 @@ export interface CapabilityRouterMap<TRouter = unknown> {
     readonly reboot: TRouter;
     readonly recording: TRouter;
     readonly recordingExport: TRouter;
+    readonly recordingOnboard: TRouter;
     readonly recordingSignal: TRouter;
     readonly sceneMonitor: TRouter;
     readonly scriptRunner: TRouter;
@@ -488,8 +494,8 @@ export interface CapabilityRouterMap<TRouter = unknown> {
     readonly zoneRules: TRouter;
     readonly zones: TRouter;
 }
-/** Capability names whose mode is `singleton` (129 caps). */
-export declare const SINGLETON_CAPABILITY_NAMES: readonly ["accessories", "addon-pages", "addon-settings", "addon-widgets", "addons", "admin-ui", "air-quality-sensor", "alarm-panel", "alerts", "ambient-light-sensor", "audio-analysis", "audio-analyzer", "audio-codec", "audio-metrics", "automation-control", "backup", "battery", "binary", "brightness", "button", "camera-credentials", "camera-grid-layout", "camera-pipeline-config", "camera-streams", "carbon-monoxide", "climate-control", "color", "connectivity", "consumables", "contact", "control", "core-blocks", "cover", "day-night", "decoder", "detection-pipeline", "device-adoption", "device-discovery", "device-manager", "device-ops", "device-state", "device-status", "doorbell", "enum-sensor", "event-emitter", "events", "face-gallery", "fan-control", "feature-probe", "filesystem-browse", "flood", "gas", "humidifier", "humidity-sensor", "image", "image-settings", "integrations", "intercom", "lawn-mower-control", "llm-runtime", "local-network", "lock-control", "media-player", "metrics-provider", "model-convert", "model-distributor", "motion", "motion-detection", "motion-trigger", "motion-zones", "native-object-detection", "navigation", "network-link", "network-quality", "nodes", "notification-rules", "notifier", "numeric-sensor", "osd", "osd-manager", "pet-feeder", "pipeline-analytics", "pipeline-executor", "pipeline-orchestrator", "pipeline-runner", "plate-gallery", "platform-probe", "power-meter", "presence", "pressure-sensor", "privacy-mask", "ptz", "ptz-autotrack", "reboot", "recording", "recording-export", "recording-signal", "scene-monitor", "script-runner", "server-management", "settings-store", "smoke", "snapshot", "sso-bridge", "storage", "storage-migration", "stream-broker", "stream-catalog", "stream-params", "stream-signals", "switch", "system", "tamper", "temperature-sensor", "terminal-session", "toast", "update", "user-management", "vacuum-control", "valve", "vector-store", "vibration", "viewer-ui", "water-heater", "weather", "webrtc-session", "zone-analytics", "zone-rules", "zones"];
+/** Capability names whose mode is `singleton` (131 caps). */
+export declare const SINGLETON_CAPABILITY_NAMES: readonly ["accessories", "addon-pages", "addon-settings", "addon-widgets", "addons", "admin-ui", "air-quality-sensor", "alarm-panel", "alerts", "ambient-light-sensor", "audio-analysis", "audio-analyzer", "audio-codec", "audio-metrics", "automation-control", "backup", "battery", "binary", "brightness", "button", "camera-credentials", "camera-grid-layout", "camera-pipeline-config", "camera-streams", "carbon-monoxide", "climate-control", "color", "connectivity", "consumables", "contact", "control", "core-blocks", "cover", "day-night", "decoder", "detection-pipeline", "device-admin-link", "device-adoption", "device-discovery", "device-manager", "device-ops", "device-state", "device-status", "doorbell", "enum-sensor", "event-emitter", "events", "face-gallery", "fan-control", "feature-probe", "filesystem-browse", "flood", "gas", "humidifier", "humidity-sensor", "image", "image-settings", "integrations", "intercom", "lawn-mower-control", "llm-runtime", "local-network", "lock-control", "media-player", "metrics-provider", "model-convert", "model-distributor", "motion", "motion-detection", "motion-trigger", "motion-zones", "native-object-detection", "navigation", "network-link", "network-quality", "nodes", "notification-rules", "notifier", "numeric-sensor", "osd", "osd-manager", "pet-feeder", "pipeline-analytics", "pipeline-executor", "pipeline-orchestrator", "pipeline-runner", "plate-gallery", "platform-probe", "power-meter", "presence", "pressure-sensor", "privacy-mask", "ptz", "ptz-autotrack", "reboot", "recording", "recording-export", "recording-onboard", "recording-signal", "scene-monitor", "script-runner", "server-management", "settings-store", "smoke", "snapshot", "sso-bridge", "storage", "storage-migration", "stream-broker", "stream-catalog", "stream-params", "stream-signals", "switch", "system", "tamper", "temperature-sensor", "terminal-session", "toast", "update", "user-management", "vacuum-control", "valve", "vector-store", "vibration", "viewer-ui", "water-heater", "weather", "webrtc-session", "zone-analytics", "zone-rules", "zones"];
 /** Union of singleton capability names (literal string union). */
 export type SingletonCapabilityName = typeof SINGLETON_CAPABILITY_NAMES[number];
 /** Capability names whose mode is `collection` (29 caps). */

package/dist/generated/device-local-state.d.ts

@@ -48,6 +48,7 @@ import { presenceCapability } from '../capabilities/presence.cap.js';
 import { pressureSensorCapability } from '../capabilities/pressure-sensor.cap.js';
 import { privacyMaskCapability } from '../capabilities/privacy-mask.cap.js';
 import { ptzAutotrackCapability } from '../capabilities/ptz-autotrack.cap.js';
+import { recordingOnboardCapability } from '../capabilities/recording-onboard.cap.js';
 import { recordingSignalCapability } from '../capabilities/recording-signal.cap.js';
 import { sceneMonitorCapability } from '../capabilities/scene-monitor.cap.js';
 import { scriptRunnerCapability } from '../capabilities/script-runner.cap.js';
@@ -128,6 +129,7 @@ export interface DeviceLocalState {
     pressureSensor: InferRuntimeState<typeof pressureSensorCapability>;
     privacyMask: InferRuntimeState<typeof privacyMaskCapability>;
     ptzAutotrack: InferRuntimeState<typeof ptzAutotrackCapability>;
+    recordingOnboard: InferRuntimeState<typeof recordingOnboardCapability>;
     recordingSignal: InferRuntimeState<typeof recordingSignalCapability>;
     sceneMonitor: InferRuntimeState<typeof sceneMonitorCapability>;
     scriptRunner: InferRuntimeState<typeof scriptRunnerCapability>;
@@ -218,6 +220,7 @@ export interface CapNameToRuntimeStateMap {
     'pressure-sensor': InferRuntimeState<typeof pressureSensorCapability>;
     'privacy-mask': InferRuntimeState<typeof privacyMaskCapability>;
     'ptz-autotrack': InferRuntimeState<typeof ptzAutotrackCapability>;
+    'recording-onboard': InferRuntimeState<typeof recordingOnboardCapability>;
     'recording-signal': InferRuntimeState<typeof recordingSignalCapability>;
     'scene-monitor': InferRuntimeState<typeof sceneMonitorCapability>;
     'script-runner': InferRuntimeState<typeof scriptRunnerCapability>;

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

@@ -26,6 +26,7 @@ import type { controlCapability } from '../capabilities/control.cap.js';
 import type { coverCapability } from '../capabilities/cover.cap.js';
 import type { dayNightCapability } from '../capabilities/day-night.cap.js';
 import type { detectionPipelineCapability } from '../capabilities/detection-pipeline.cap.js';
+import type { deviceAdminLinkCapability } from '../capabilities/device-admin-link.cap.js';
 import type { deviceDiscoveryCapability } from '../capabilities/device-discovery.cap.js';
 import type { deviceOpsCapability } from '../capabilities/device-ops.cap.js';
 import type { deviceStatusCapability } from '../capabilities/device-status.cap.js';
@@ -65,6 +66,7 @@ import type { privacyMaskCapability } from '../capabilities/privacy-mask.cap.js'
 import type { ptzCapability } from '../capabilities/ptz.cap.js';
 import type { ptzAutotrackCapability } from '../capabilities/ptz-autotrack.cap.js';
 import type { rebootCapability } from '../capabilities/reboot.cap.js';
+import type { recordingOnboardCapability } from '../capabilities/recording-onboard.cap.js';
 import type { recordingSignalCapability } from '../capabilities/recording-signal.cap.js';
 import type { sceneMonitorCapability } from '../capabilities/scene-monitor.cap.js';
 import type { scriptRunnerCapability } from '../capabilities/script-runner.cap.js';
@@ -160,6 +162,7 @@ export interface DeviceProxyState {
     readonly pressureSensor: SliceHandle<InferRuntimeState<typeof pressureSensorCapability>>;
     readonly privacyMask: SliceHandle<InferRuntimeState<typeof privacyMaskCapability>>;
     readonly ptzAutotrack: SliceHandle<InferRuntimeState<typeof ptzAutotrackCapability>>;
+    readonly recordingOnboard: SliceHandle<InferRuntimeState<typeof recordingOnboardCapability>>;
     readonly recordingSignal: SliceHandle<InferRuntimeState<typeof recordingSignalCapability>>;
     readonly sceneMonitor: SliceHandle<InferRuntimeState<typeof sceneMonitorCapability>>;
     readonly scriptRunner: SliceHandle<InferRuntimeState<typeof scriptRunnerCapability>>;
@@ -222,6 +225,7 @@ export interface DeviceProxy {
     readonly cover?: InferDeviceProxyCap<typeof coverCapability>;
     readonly dayNight?: InferDeviceProxyCap<typeof dayNightCapability>;
     readonly detectionPipeline?: InferDeviceProxyCap<typeof detectionPipelineCapability>;
+    readonly deviceAdminLink?: InferDeviceProxyCap<typeof deviceAdminLinkCapability>;
     readonly deviceDiscovery?: InferDeviceProxyCap<typeof deviceDiscoveryCapability>;
     readonly deviceOps?: InferDeviceProxyCap<typeof deviceOpsCapability>;
     readonly deviceStatus?: InferDeviceProxyCap<typeof deviceStatusCapability>;
@@ -261,6 +265,7 @@ export interface DeviceProxy {
     readonly ptz?: InferDeviceProxyCap<typeof ptzCapability>;
     readonly ptzAutotrack?: InferDeviceProxyCap<typeof ptzAutotrackCapability>;
     readonly reboot?: InferDeviceProxyCap<typeof rebootCapability>;
+    readonly recordingOnboard?: InferDeviceProxyCap<typeof recordingOnboardCapability>;
     readonly recordingSignal?: InferDeviceProxyCap<typeof recordingSignalCapability>;
     readonly sceneMonitor?: InferDeviceProxyCap<typeof sceneMonitorCapability>;
     readonly scriptRunner?: InferDeviceProxyCap<typeof scriptRunnerCapability>;

package/dist/generated/device-scoped-caps.d.ts

@@ -5,7 +5,7 @@
  * can answer "may a rule actuate this?" without importing the schema barrel
  * (~144MB RSS per runner, D28).
  *
- * Coverage: 85 device-scoped capabilities.
+ * Coverage: 87 device-scoped capabilities.
  */
 export declare const DEVICE_SCOPED_CAPS: ReadonlySet<string>;
 /**

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: 1164 method paths across 158 capabilities.
+ * Coverage: 1169 method paths across 160 capabilities.
  */
 import type { CapabilityMethodAccess } from '../capabilities/capability-definition.js';
 export interface MethodAccessRecord {

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

@@ -6,7 +6,7 @@
  * system-scope cap that takes a deviceId was previously never device-filtered
  * — see the generator header).
  *
- * Coverage: 391 methods carry a device reference, of which
+ * Coverage: 395 methods carry a device reference, of which
  * 141 are on SYSTEM-scope caps.
  *
  * Top-level fields, number arrays, and one-level arrays of objects carrying

package/dist/generated/runtime-state-durability.d.ts

@@ -11,7 +11,7 @@ export interface RuntimeStatePolicy {
 }
 /**
  * Per-cap runtime-state policy, projected from every `*.cap.ts` that declares
- * `runtimeState`. 68 caps: 35 `restored`, 33 `session`.
+ * `runtimeState`. 69 caps: 36 `restored`, 33 `session`.
  *
  * A cap absent from this map has no runtime-state slice at all. A cap PRESENT
  * with `durability: 'session'` has one and has decided not to keep it.

package/dist/index.d.ts

@@ -176,6 +176,8 @@ export { ChargingStatus, DeviceFeature, DeviceRole, DeviceType } from './device/
 export type { IBatteryOperated, IDoorbellButton, INativeSnapshot, IPanTiltZoom, IRebootable, ITwoWayAudio, } from './device/features.js';
 export type { LocationDescriptionAssignment, LocationIconAssignment, LocationIconId, } from './device/location-icon.js';
 export { LOCATION_ICON_FALLBACK, LOCATION_ICON_IDS, LOCATION_DESCRIPTION_MAX, LocationDescriptionAssignmentSchema, LocationIconAssignmentSchema, LocationIconIdSchema, locationIconKey, resolveLocationIcon, } from './device/location-icon.js';
+export type { DisplayIconEntry, DisplayIconGroup, DisplayIconHit, } from './device/display-icon-vocabulary.js';
+export { DISPLAY_ICON_GROUPS, DISPLAY_ICON_KEYS, DISPLAY_ICON_OFFERED_KEYS, DISPLAY_ICON_VOCABULARY, displayIconEntry, displayIconsInGroup, isDisplayIconKey, searchDisplayIcons, } from './device/display-icon-vocabulary.js';
 export { getByPath, setByPath } from './device/path-util.js';
 export type { ReachabilityPollHandle, ReachabilityPollLogger, ReachabilityPollOptions, } from './device/reachability-poll.js';
 export { REACHABILITY_FAILURES_TO_OFFLINE, REACHABILITY_POLL_INTERVAL_MS, REACHABILITY_PROBE_TIMEOUT_MS, startReachabilityPoll, } from './device/reachability-poll.js';