@camstack/types 1.2.589 → 1.2.590

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (44) hide show
  1. package/CHANGELOG.md +6 -0
  2. package/dist/addon.js +4 -4
  3. package/dist/addon.mjs +4 -4
  4. package/dist/capabilities/battery.cap.d.ts +7 -41
  5. package/dist/capabilities/index.d.ts +5 -1
  6. package/dist/capabilities/low-power-sleep.cap.d.ts +83 -0
  7. package/dist/capabilities/resync.cap.d.ts +40 -0
  8. package/dist/client.js +9 -4
  9. package/dist/client.mjs +9 -4
  10. package/dist/{composed-stable-id-Kt5VKzGZ.mjs → composed-stable-id-BNTaDZEh.mjs} +9 -8
  11. package/dist/{composed-stable-id-DDv-Og0u.js → composed-stable-id-BdeYe5dD.js} +9 -8
  12. package/dist/device/device-feature-requirements.d.ts +3 -4
  13. package/dist/device/device-profile.d.ts +1 -1
  14. package/dist/device/device-type.d.ts +9 -8
  15. package/dist/device/low-power-sleep.d.ts +19 -0
  16. package/dist/device/resync-through-adoption.d.ts +12 -0
  17. package/dist/enums/event-category.d.ts +1 -1
  18. package/dist/enums.js +1 -1
  19. package/dist/enums.mjs +1 -1
  20. package/dist/{event-category-CE_VCE2G.js → event-category-BKxXXxnV.js} +1 -1
  21. package/dist/{event-category-Hwx_JSCU.mjs → event-category-CY27-fF0.mjs} +1 -1
  22. package/dist/generated/addon-api.d.ts +37 -8
  23. package/dist/generated/addon-cap-facts.d.ts +1 -1
  24. package/dist/generated/cap-status-types.d.ts +3 -1
  25. package/dist/generated/cap-vocabulary.d.ts +1 -1
  26. package/dist/generated/capability-router-map.d.ts +8 -2
  27. package/dist/generated/device-local-state.d.ts +3 -0
  28. package/dist/generated/device-proxy.d.ts +5 -0
  29. package/dist/generated/device-scoped-caps.d.ts +1 -1
  30. package/dist/generated/history-catalog.d.ts +1 -1
  31. package/dist/generated/method-access-map.d.ts +1 -1
  32. package/dist/generated/method-device-selectors.d.ts +1 -1
  33. package/dist/generated/runtime-state-durability.d.ts +1 -1
  34. package/dist/{implemented-methods-CbdShcW1.js → implemented-methods-BarLh7tc.js} +1 -1
  35. package/dist/{implemented-methods-BiV3Y-40.mjs → implemented-methods-k3KProJd.mjs} +1 -1
  36. package/dist/index.d.ts +2 -0
  37. package/dist/index.js +252 -66
  38. package/dist/index.mjs +246 -67
  39. package/dist/interfaces/event-bus.d.ts +1 -1
  40. package/dist/node.js +2 -2
  41. package/dist/node.mjs +2 -2
  42. package/dist/{sleep-CICYFVJf.js → sleep-BA_SIc0O.js} +47 -9
  43. package/dist/{sleep-CFN40XWx.mjs → sleep-BT1bLgPq.mjs} +47 -9
  44. package/package.json +1 -1
package/CHANGELOG.md CHANGED
@@ -7,6 +7,12 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
7
7
 
8
8
  ## [Unreleased]
9
9
 
10
+ ## [1.2.590] - 2026-11-17
11
+
12
+ ### Changed
13
+
14
+ - A camera that sleeps now says so through its own capability (low-power-sleep) — a device that only reports a battery is no longer treated as sleeping; Re-sync is offered by the devices that can do it
15
+
10
16
  ## [1.2.589] - 2026-11-17
11
17
 
12
18
  ### Changed
package/dist/addon.js CHANGED
@@ -1,7 +1,7 @@
1
1
  Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
2
- const require_sleep = require("./sleep-CICYFVJf.js");
3
- const require_event_category = require("./event-category-CE_VCE2G.js");
4
- const require_composed_stable_id = require("./composed-stable-id-DDv-Og0u.js");
2
+ const require_sleep = require("./sleep-BA_SIc0O.js");
3
+ const require_event_category = require("./event-category-BKxXXxnV.js");
4
+ const require_composed_stable_id = require("./composed-stable-id-BdeYe5dD.js");
5
5
  //#region src/generated/cap-input-defaults.ts
6
6
  /**
7
7
  * AUTO-GENERATED by scripts/generate-cap-input-defaults.ts — DO NOT EDIT.
@@ -34,7 +34,6 @@ var CAP_INPUT_DEFAULTS = Object.freeze({
34
34
  "pullEncoded": { "maxCount": 8 },
35
35
  "pullPcm": { "maxCount": 8 }
36
36
  },
37
- "battery": { "wakeForStream": { "timeoutMs": 8e3 } },
38
37
  "control": {
39
38
  "next": { "cycle": true },
40
39
  "previous": { "cycle": true }
@@ -92,6 +91,7 @@ var CAP_INPUT_DEFAULTS = Object.freeze({
92
91
  "idleStopMinutes": 30
93
92
  } } }
94
93
  },
94
+ "low-power-sleep": { "wakeUp": { "timeoutMs": 8e3 } },
95
95
  "media-player": {
96
96
  "channelDown": { "steps": 1 },
97
97
  "channelUp": { "steps": 1 },
package/dist/addon.mjs CHANGED
@@ -1,6 +1,6 @@
1
- import { $ as PipelineStepInputSchema, $n as StoredRecordKindDeclarationSchema, $r as REMOVE_LEAF, A as CAP_ADVANCE_FIELDS, An as clearKnownSecrets, Ar as normalizeAddonInitResult, At as createDebugEmitter, B as describeCustomActions, Bi as RecordNotFoundError, Br as SCOPED_SETTINGS_SCOPES, Ca as makeSecretMarker, Ci as buildSecretRef, Cn as makeInMemoryRecords, Di as normalizeSecretOwner, Dn as REVALIDATE_AFTER_MS, Dr as BaseAddon, Ei as isSecretRef, En as resolveSecretViewsIn, F as isCapMethodAbsent, Fi as ForeignSecretMarkerError, Fn as shortSecretRefHash, G as nodePin, Gi as RevConflictError, Gn as defineEntryKind, Hi as RecordTooLargeError, Hn as DATAPLANE_SECRET_HEADER, Hr as resolveDeviceSettings, I as CALLER_STAMPED_CAPABILITIES, Ii as InvalidRecordError, In as PEER_BYTES_CHUNK_BYTES, Ji as UnknownRecordKindError, Jn as RecordFieldPathSchema, K as readCommandOrigin, Ki as TransactRefusedError, Kn as entryBody, L as withoutCallerStamp, Li as NoCallerError, Ln as PEER_BYTES_MAX_OUTSTANDING, Ma as AddonMigrationsBlockedError, Mi as BatchTooLargeError, Mn as knownSecretCount, N as CAP_STATE_LEAVES, Na as findMigrationsBlocked, Ni as DeclarationRefusedError, Nn as registerKnownSecret, O as HF_REPO, Oi as parseSecretRef, On as createSecretsAccess, P as CAP_METHOD_NOT_IMPLEMENTED, Pi as FilterRequiredError, Pn as scrubKnownSecrets, Q as PipelineRunResultBridge, Qn as RecordRetentionSchema, Qr as secretViewsOf, R as customAction, Ri as PlaintextSecretError, Rn as PEER_BYTES_STALL_MS, Sa as isSecretMarkerLike, Si as arrayItemFieldPath, Sn as ruleFireOfClaim, Sr as ErrorI18nPayloadSchema, St as scopeKey, T as isCommand, Ti as globalSecretScope, Tn as assertTransactScope, Tr as readErrorI18n, Ui as RecordUniqueViolationError, Ur as resolvedValues, Vi as RecordSecretUnavailableError, Vn as CALLER_USERNAME_HEADER, Vr as nodeIdOfScopedKey, W as commandOrigin, Wi as RecordsError, Wn as DisposerChain, X as SWITCH_SETTABLE_GATE, Xi as recordsErrorFromMessage, Xn as RecordKindDeclarationSchema, Y as viewerUiCapability, Yi as asRecordsError, Yn as RecordIndexSchema, Z as switchRefusesSetState, Zn as RecordKindNameSchema, _a as SECRET_CLEAR, _i as RECORD_QUERY_MAX, _t as MODEL_FORMATS, ai as recordSecretRef, ar as isZodSecret, ba as isSecretFieldView, bi as RECORD_SWEEP_INTERVAL_MS, bn as OnBehalfSourceSchema, c as asString, ci as RECORD_BATCH_MAX_BYTES, d as parseJsonUnknown, di as RECORD_DEFAULT_MAX_DATA_BYTES, ei as collectSecretLeaves, er as assertValidDeclaration, et as MIGRATION_API_VERSION, f as hfModelUrl, fi as RECORD_DELETE_BATCH, g as createDeviceProxy, gi as RECORD_MAX_INDEX_FIELDS, h as isDeviceScopedCap, hi as RECORD_MAX_INDEXES, ii as recordSecretCollection, ir as collectZodSecretPaths, it as adminUiCapability, j as CAP_METHOD_TIMEOUTS_MS, jn as forgetKnownSecret, kn as MIN_SCRUBBED_LENGTH, li as RECORD_CLASSES, m as DEVICE_SCOPED_CAPS, mi as RECORD_MAX_DATA_BYTES, ni as parseSecretPath, nr as defineRecordKinds, nt as deviceOpsCapability, o as asJsonObject, oa as createEvent, oi as secretArrayPrefixes, ot as addonPagesSourceCapability, p as BOOT_RECOVERY_BACKOFF_MS, pi as RECORD_ID_MAX_LENGTH, pr as expandCapMethods, q as readNodePin, qi as UnindexedFilterError, qn as EntryDescriptorSchema, r as maskUrlCredentials, ri as recordArrayItemPath, rt as DEVICE_CHILDREN_BATCH_MAX, sa as emitReadiness, si as RECORD_BATCH_MAX, t as sleep, ti as mapSecretLeaves, tr as declarationsOf, ui as RECORD_DATABASES, v as addonSliceHandleApi, va as classifySecretWrite, vi as RECORD_SECRET_COLLECTION_PREFIX, vn as CommandOriginClaimSchema, vt as ReadinessRegistry, wa as toSecretFieldView, wi as formatSecretScope, wn as createRecordsAccess, xa as isSecretMarker, xi as SECRET_REF_SCHEME, xn as RuleFireOriginSchema, y as createEventBusSliceSource, ya as isSecretClear, yi as RECORD_SETTINGS_MAX_ROWS, yn as OnBehalfSchema, yt as ReadinessTimeoutError, z as defineCustomActions, zi as RECORDS_ERROR_CODES, zn as PEER_BYTES_TICKET_TTL_MS } from "./sleep-CFN40XWx.mjs";
2
- import { t as EventCategory } from "./event-category-Hwx_JSCU.mjs";
3
- import { a as DeviceType, s as errMsg, t as COMPOSED_DEVICE_STABLE_ID_PREFIX } from "./composed-stable-id-Kt5VKzGZ.mjs";
1
+ import { $ as PipelineStepInputSchema, $n as StoredRecordKindDeclarationSchema, $r as REMOVE_LEAF, A as CAP_ADVANCE_FIELDS, An as clearKnownSecrets, Ar as normalizeAddonInitResult, At as createDebugEmitter, B as describeCustomActions, Bi as RecordNotFoundError, Br as SCOPED_SETTINGS_SCOPES, Ca as makeSecretMarker, Ci as buildSecretRef, Cn as makeInMemoryRecords, Di as normalizeSecretOwner, Dn as REVALIDATE_AFTER_MS, Dr as BaseAddon, Ei as isSecretRef, En as resolveSecretViewsIn, F as isCapMethodAbsent, Fi as ForeignSecretMarkerError, Fn as shortSecretRefHash, G as nodePin, Gi as RevConflictError, Gn as defineEntryKind, Hi as RecordTooLargeError, Hn as DATAPLANE_SECRET_HEADER, Hr as resolveDeviceSettings, I as CALLER_STAMPED_CAPABILITIES, Ii as InvalidRecordError, In as PEER_BYTES_CHUNK_BYTES, Ji as UnknownRecordKindError, Jn as RecordFieldPathSchema, K as readCommandOrigin, Ki as TransactRefusedError, Kn as entryBody, L as withoutCallerStamp, Li as NoCallerError, Ln as PEER_BYTES_MAX_OUTSTANDING, Ma as AddonMigrationsBlockedError, Mi as BatchTooLargeError, Mn as knownSecretCount, N as CAP_STATE_LEAVES, Na as findMigrationsBlocked, Ni as DeclarationRefusedError, Nn as registerKnownSecret, O as HF_REPO, Oi as parseSecretRef, On as createSecretsAccess, P as CAP_METHOD_NOT_IMPLEMENTED, Pi as FilterRequiredError, Pn as scrubKnownSecrets, Q as PipelineRunResultBridge, Qn as RecordRetentionSchema, Qr as secretViewsOf, R as customAction, Ri as PlaintextSecretError, Rn as PEER_BYTES_STALL_MS, Sa as isSecretMarkerLike, Si as arrayItemFieldPath, Sn as ruleFireOfClaim, Sr as ErrorI18nPayloadSchema, St as scopeKey, T as isCommand, Ti as globalSecretScope, Tn as assertTransactScope, Tr as readErrorI18n, Ui as RecordUniqueViolationError, Ur as resolvedValues, Vi as RecordSecretUnavailableError, Vn as CALLER_USERNAME_HEADER, Vr as nodeIdOfScopedKey, W as commandOrigin, Wi as RecordsError, Wn as DisposerChain, X as SWITCH_SETTABLE_GATE, Xi as recordsErrorFromMessage, Xn as RecordKindDeclarationSchema, Y as viewerUiCapability, Yi as asRecordsError, Yn as RecordIndexSchema, Z as switchRefusesSetState, Zn as RecordKindNameSchema, _a as SECRET_CLEAR, _i as RECORD_QUERY_MAX, _t as MODEL_FORMATS, ai as recordSecretRef, ar as isZodSecret, ba as isSecretFieldView, bi as RECORD_SWEEP_INTERVAL_MS, bn as OnBehalfSourceSchema, c as asString, ci as RECORD_BATCH_MAX_BYTES, d as parseJsonUnknown, di as RECORD_DEFAULT_MAX_DATA_BYTES, ei as collectSecretLeaves, er as assertValidDeclaration, et as MIGRATION_API_VERSION, f as hfModelUrl, fi as RECORD_DELETE_BATCH, g as createDeviceProxy, gi as RECORD_MAX_INDEX_FIELDS, h as isDeviceScopedCap, hi as RECORD_MAX_INDEXES, ii as recordSecretCollection, ir as collectZodSecretPaths, it as adminUiCapability, j as CAP_METHOD_TIMEOUTS_MS, jn as forgetKnownSecret, kn as MIN_SCRUBBED_LENGTH, li as RECORD_CLASSES, m as DEVICE_SCOPED_CAPS, mi as RECORD_MAX_DATA_BYTES, ni as parseSecretPath, nr as defineRecordKinds, nt as deviceOpsCapability, o as asJsonObject, oa as createEvent, oi as secretArrayPrefixes, ot as addonPagesSourceCapability, p as BOOT_RECOVERY_BACKOFF_MS, pi as RECORD_ID_MAX_LENGTH, pr as expandCapMethods, q as readNodePin, qi as UnindexedFilterError, qn as EntryDescriptorSchema, r as maskUrlCredentials, ri as recordArrayItemPath, rt as DEVICE_CHILDREN_BATCH_MAX, sa as emitReadiness, si as RECORD_BATCH_MAX, t as sleep, ti as mapSecretLeaves, tr as declarationsOf, ui as RECORD_DATABASES, v as addonSliceHandleApi, va as classifySecretWrite, vi as RECORD_SECRET_COLLECTION_PREFIX, vn as CommandOriginClaimSchema, vt as ReadinessRegistry, wa as toSecretFieldView, wi as formatSecretScope, wn as createRecordsAccess, xa as isSecretMarker, xi as SECRET_REF_SCHEME, xn as RuleFireOriginSchema, y as createEventBusSliceSource, ya as isSecretClear, yi as RECORD_SETTINGS_MAX_ROWS, yn as OnBehalfSchema, yt as ReadinessTimeoutError, z as defineCustomActions, zi as RECORDS_ERROR_CODES, zn as PEER_BYTES_TICKET_TTL_MS } from "./sleep-BT1bLgPq.mjs";
2
+ import { t as EventCategory } from "./event-category-CY27-fF0.mjs";
3
+ import { a as DeviceType, s as errMsg, t as COMPOSED_DEVICE_STABLE_ID_PREFIX } from "./composed-stable-id-BNTaDZEh.mjs";
4
4
  //#region src/generated/cap-input-defaults.ts
5
5
  /**
6
6
  * AUTO-GENERATED by scripts/generate-cap-input-defaults.ts — DO NOT EDIT.
@@ -33,7 +33,6 @@ var CAP_INPUT_DEFAULTS = Object.freeze({
33
33
  "pullEncoded": { "maxCount": 8 },
34
34
  "pullPcm": { "maxCount": 8 }
35
35
  },
36
- "battery": { "wakeForStream": { "timeoutMs": 8e3 } },
37
36
  "control": {
38
37
  "next": { "cycle": true },
39
38
  "previous": { "cycle": true }
@@ -91,6 +90,7 @@ var CAP_INPUT_DEFAULTS = Object.freeze({
91
90
  "idleStopMinutes": 30
92
91
  } } }
93
92
  },
93
+ "low-power-sleep": { "wakeUp": { "timeoutMs": 8e3 } },
94
94
  "media-player": {
95
95
  "channelDown": { "steps": 1 },
96
96
  "channelUp": { "steps": 1 },
@@ -3,9 +3,9 @@ import { type InferProvider } from './capability-definition.js';
3
3
  import { DeviceType } from '../device/device-type.js';
4
4
  import { EventCategory } from '../enums/event-category.js';
5
5
  /**
6
- * Battery status snapshot. Emitted by providers whose device is
7
- * battery-operated (cameras with `DeviceFeature.BatteryOperated`,
8
- * future sensor/button accessories). Consumers build their own "low
6
+ * Battery status snapshot. Emitted by providers whose device reports a
7
+ * battery (`DeviceFeature.BatteryOperated`): battery cameras, sensors,
8
+ * buttons. Whether the device SLEEPS is `low-power-sleep`, not this cap. Consumers build their own "low
9
9
  * battery" alerting on top — the cap deliberately does NOT enforce a
10
10
  * threshold.
11
11
  */
@@ -31,46 +31,12 @@ export declare const batteryCapability: {
31
31
  readonly deviceNative: true;
32
32
  readonly mode: 'singleton';
33
33
  readonly deviceTypes: readonly [DeviceType.Camera, DeviceType.Sensor, DeviceType.Button, DeviceType.Switch, DeviceType.PetFeeder, DeviceType.Container, DeviceType.Climate, DeviceType.EventEmitter];
34
- readonly methods: {
35
- /**
36
- * Explicitly wake the camera from low-power sleep ahead of a
37
- * streaming session start. Consumers that initiate a stream
38
- * against a sleeping battery cam (HomeKit Secure Video, Alexa
39
- * RTCSession, snapshot wrappers) call this with a short timeout
40
- * before establishing the media pipeline — the broker's own
41
- * passive wake-on-dial works but adds 5–7 seconds to first-frame,
42
- * during which the consumer renders a black screen. Pre-waking
43
- * compresses that gap.
44
- *
45
- * Returns `awoke: true` when the firmware acknowledged the wake
46
- * before `timeoutMs`. Returns `awoke: false` when it timed out OR
47
- * the cap surface is unavailable (no Baichuan / firmware
48
- * channel); the caller should still attempt the stream — the
49
- * passive broker wake remains as fallback.
50
- */
51
- readonly wakeForStream: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
52
- deviceId: z.ZodNumber;
53
- timeoutMs: z.ZodDefault<z.ZodNumber>;
54
- }, z.core.$strip>, z.ZodObject<{
55
- awoke: z.ZodBoolean;
56
- durationMs: z.ZodNumber;
57
- }, z.core.$strip>, "mutation">;
58
- };
59
34
  /**
60
- * A composed provider (battery ADDED to a pet feeder or container that has
61
- * no wake surface) answers `wakeForStream` with the same "unavailable"
62
- * result the contract already defines above: "Returns `awoke: false` when
63
- * … the cap surface is unavailable." (D663).
35
+ * No methods: waking a sleeping camera is `low-power-sleep.wakeUp`
36
+ * (#459, Q2). A battery reading says nothing about sleep — a battery sensor
37
+ * reports charge and never needs waking.
64
38
  */
65
- readonly composedMethods: {
66
- readonly wakeForStream: {
67
- readonly kind: 'answer';
68
- readonly value: {
69
- readonly awoke: false;
70
- readonly durationMs: 0;
71
- };
72
- };
73
- };
39
+ readonly methods: {};
74
40
  readonly events: {
75
41
  /**
76
42
  * Emitted whenever the cached status changes (firmware push OR
@@ -259,6 +259,8 @@ export { type IPtzProvider, type PtzHomePreset, PtzHomePresetSchema, type PtzHom
259
259
  export { type IPtzAutotrackProvider, type PtzAutotrackRuntimeState, PtzAutotrackRuntimeStateSchema, type PtzAutotrackSettings, PtzAutotrackSettingsSchema, type PtzAutotrackStatus, PtzAutotrackStatusSchema, type PtzAutotrackTargetOption, PtzAutotrackTargetOptionSchema, ptzAutotrackCapability, } from './ptz-autotrack.cap.js';
260
260
  export { type IRunningStateProvider, type RunningStateSource, RunningStateSourceSchema, type RunningStateStatus, RunningStateStatusSchema, runningStateCapability, } from './running-state.cap.js';
261
261
  export { type IRebootProvider, rebootCapability } from './reboot.cap.js';
262
+ export { type ILowPowerSleepProvider, type LowPowerSleepStatus, LowPowerSleepStatusSchema, lowPowerSleepCapability, } from './low-power-sleep.cap.js';
263
+ export { type IResyncProvider, ResyncDeviceInputSchema, resyncCapability } from './resync.cap.js';
262
264
  export { type IRecordingProvider, RECORDING_SOURCE_CAMSTACK, RECORDING_SOURCE_CAMSTACK_ADDON, type RecordingAvailability, RecordingAvailabilitySchema, type RecordingDays, RecordingDaysSchema, type RecordingManifest, RecordingManifestSchema, type RecordingPlayback, RecordingPlaybackSchema, RecordingRangeSchema, type RecordingRead, RecordingReadSchema, type RecordingSource, type RecordingSourceAvailability, RecordingSourceAvailabilitySchema, type RecordingSourceOptions, RecordingSourceOptionsSchema, RecordingSourceSchema, recordingCapability, } from './recording.cap.js';
263
265
  export { type IRecordingArchiveProvider, type LocateSegmentResult, LocateSegmentResultSchema, RECORDING_TIMELINE_BATCH_MAX, type ReadGopBytesResult, ReadGopBytesResultSchema, type ReadSegmentBytesResult, ReadSegmentBytesResultSchema, type ReadWindowBytesResult, ReadWindowBytesResultSchema, type RecordingAvailabilityForDevice, RecordingAvailabilityForDeviceSchema, type RecordingDaysForDevice, RecordingDaysForDeviceSchema, type RecordingDeviceUsage, RecordingDeviceUsageSchema, type RecordingLocationUsage, RecordingLocationUsageSchema, type RecordingRebalanceInput, RecordingRebalanceInputSchema, type RecordingRebalanceMove, RecordingRebalanceMoveSchema, type RecordingRebalancePlan, RecordingRebalancePlanSchema, type RecordingRebalanceSkip, type RecordingRebalanceSkipReason, RecordingRebalanceSkipReasonSchema, RecordingRebalanceSkipSchema, type RecordingStatus, RecordingStatusSchema, type RecordingStorageUsage, RecordingStorageUsageSchema, recordingArchiveCapability, } from './recording-archive.cap.js';
264
266
  export { type ClipExportFailure, ClipExportFailureSchema, clipExportFailure, clipExportFailureOf, EXPORT_DENSE_MAX_RANGES, type ExportBytes, ExportBytesSchema, type ExportClipSubject, ExportClipSubjectSchema, type ExportDense, type ExportDenseRange, ExportDenseRangeSchema, ExportDenseSchema, type ExportDownload, ExportDownloadSchema, type ExportFootageSubject, ExportFootageSubjectSchema, type ExportOptions, ExportOptionsSchema, type ExportRecord, ExportRecordSchema, ExportSpeedSchema, type ExportState, ExportStateSchema, type ExportSubject, ExportSubjectSchema, ExportTimelapseSchema, exportSubjectOf, type IRecordingExportProvider, RECORDING_EXPORT_MAX_READ_BYTES, recordingExportCapability, resolveCreateExportSubject, resolveExportProfiles, } from './recording-export.cap.js';
@@ -459,6 +461,8 @@ import type { ptzCapability } from './ptz.cap.js';
459
461
  import type { ptzAutotrackCapability } from './ptz-autotrack.cap.js';
460
462
  import type { runningStateCapability } from './running-state.cap.js';
461
463
  import type { rebootCapability } from './reboot.cap.js';
464
+ import type { lowPowerSleepCapability } from './low-power-sleep.cap.js';
465
+ import type { resyncCapability } from './resync.cap.js';
462
466
  import type { recordingCapability } from './recording.cap.js';
463
467
  import type { recordingArchiveCapability } from './recording-archive.cap.js';
464
468
  import type { recordingExportCapability } from './recording-export.cap.js';
@@ -507,6 +511,6 @@ import type { trainingProviderCapability } from './training-provider.cap.js';
507
511
  import type { zoneAnalyticsCapability } from './zone-analytics.cap.js';
508
512
  import type { zoneRulesCapability } from './zone-rules.cap.js';
509
513
  import type { zonesCapability } from './zones.cap.js';
510
- type AnyCapability = typeof streamSignalsCapability | typeof addonSettingsCapability | typeof alertsCapability | typeof storageCapability | typeof storageMigrationCapability | typeof storageProviderCapability | typeof storageEvictableCapability | typeof storageOccupancyCapability | typeof filesystemBrowseCapability | typeof backupCapability | typeof terminalSessionCapability | typeof settingsStoreCapability | typeof dataStoreProviderCapability | typeof databaseSnapshotCapability | typeof migrationsCapability | typeof storageAdminCapability | typeof recordsCapability | typeof recordEntriesCapability | typeof deviceHistoryCapability | typeof deviceRunsCapability | typeof deviceTransitionsCapability | typeof timedRunCapability | typeof doNotDisturbCapability | typeof keychainCapability | typeof keychainAdminCapability | typeof deviceCredentialsCapability | typeof nodeCertificatesCapability | typeof logChannelsCapability | typeof logDestinationCapability | typeof loadContributionCapability | typeof failureContributionCapability | typeof deviceRemovalHookCapability | typeof nodeRemovalHookCapability | typeof adminUiCapability | typeof viewerUiCapability | typeof ssoBridgeCapability | typeof userPasskeysCapability | typeof smtpProviderCapability | typeof mqttBrokerCapability | typeof brokerCapability | typeof deviceAdoptionCapability | typeof deviceAdminLinkCapability | typeof deviceExportCapability | typeof addonPagesCapability | typeof addonPagesSourceCapability | typeof addonWidgetsCapability | typeof addonWidgetsSourceCapability | typeof customModelRegistryCapability | typeof modelDistributorCapability | typeof modelConvertCapability | typeof addonRoutesCapability | typeof streamBrokerCapability | typeof decoderCapability | typeof webrtcSessionCapability | typeof cameraStreamsCapability | typeof calendarSourceCapability | typeof calendarsCapability | typeof motionDetectionCapability | typeof pipelineExecutorCapability | typeof detectionPipelineCapability | typeof cameraPipelineConfigCapability | typeof pipelineRunnerCapability | typeof pipelineOrchestratorCapability | typeof audioAnalyzerCapability | typeof audioAnalysisCapability | typeof audioCodecCapability | typeof embeddingEncoderCapability | typeof vectorStoreCapability | typeof deviceProviderCapability | typeof deviceManagerCapability | typeof deviceStateCapability | typeof authProviderCapability | typeof loginMethodCapability | typeof networkAccessCapability | typeof boardKeySourceCapability | typeof turnProviderCapability | typeof snapshotCapability | typeof llmCapability | typeof llmRuntimeCapability | typeof notificationOutputCapability | typeof composerCapability | typeof coreBlocksCapability | typeof notificationRulesCapability | typeof pipelineAnalyticsCapability | typeof metricsProviderCapability | typeof ptzCapability | typeof ptzAutotrackCapability | typeof navigationCapability | typeof consumablesCapability | typeof runningStateCapability | typeof rebootCapability | typeof brightnessCapability | typeof colorCapability | typeof climateControlCapability | typeof coverCapability | typeof valveCapability | typeof humidifierCapability | typeof waterHeaterCapability | typeof weatherCapability | typeof weatherStationCapability | typeof imageCapability | typeof lockControlCapability | typeof powerSourceCapability | typeof vacuumControlCapability | typeof petFeederCapability | typeof petFountainCapability | typeof pumpCycleCapability | typeof lawnMowerControlCapability | typeof fanControlCapability | typeof controlCapability | typeof notifierCapability | typeof mediaPlayerCapability | typeof meterCapability | typeof alarmPanelCapability | typeof presenceCapability | typeof scriptRunnerCapability | typeof actionSourceCapability | typeof actionsCapability | typeof schedulersCapability | typeof automationControlCapability | typeof motionTriggerCapability | typeof sirenCapability | typeof zonesCapability | typeof zoneRulesCapability | typeof trainingCapability | typeof trainingProviderCapability | typeof zoneAnalyticsCapability | typeof audioMetricsCapability | typeof motionCapability | typeof contactCapability | typeof floodCapability | typeof smokeCapability | typeof carbonMonoxideCapability | typeof gasCapability | typeof groupActiveCapability | typeof groupCommandsCapability | typeof groupStatusCapability | typeof tamperCapability | typeof vibrationCapability | typeof connectivityCapability | typeof binaryCapability | typeof temperatureSensorCapability | typeof heatingValveCapability | typeof heatPumpStatusCapability | typeof energySystemCapability | typeof workloadCapability | typeof heatPumpControlCapability | typeof humiditySensorCapability | typeof ambientLightSensorCapability | typeof pressureSensorCapability | typeof powerMeterCapability | typeof airQualitySensorCapability | typeof numericSensorCapability | typeof enumSensorCapability | typeof recordingCapability | typeof recordingArchiveCapability | typeof recordingExportCapability | typeof recordingSignalCapability | typeof deviceOpsCapability | typeof displayPaletteCapability | typeof platformProbeCapability | typeof localNetworkCapability | typeof meshNetworkCapability | typeof userManagementCapability | typeof systemCapability | typeof networkQualityCapability | typeof toastCapability | typeof nodesCapability | typeof serverManagementCapability | typeof clusterUpdateCapability | typeof integrationsCapability | typeof integrationInstancesCapability | typeof addonsCapability | typeof oauthIntegrationCapability | typeof streamParamsCapability | typeof streamCatalogCapability | typeof motionZonesCapability | typeof cameraGridLayoutCapability | typeof sceneMonitorCapability | typeof privacyMaskCapability | typeof dayNightCapability | typeof recordingOnboardCapability | typeof imageSettingsCapability | typeof osdCapability | typeof osdManagerCapability | typeof accessoriesCapability | typeof batteryCapability | typeof errorCapability | typeof networkLinkCapability | typeof buttonCapability | typeof irTransmitterCapability | typeof remoteCapability | typeof heroLayoutCapability | typeof fanPresetsCapability | typeof templateCapability | typeof tagsCapability | typeof remoteLayoutComponentsCapability | typeof cameraCredentialsCapability | typeof deviceStatusCapability | typeof doorbellCapability | typeof eventEmitterCapability | typeof faceGalleryCapability | typeof featureProbeCapability | typeof intercomCapability | typeof nativeObjectDetectionCapability | typeof plateGalleryCapability | typeof switchCapability | typeof updateCapability | typeof videoclipsCapability | typeof deviceExtensionCapability | typeof dishwasherCapability;
514
+ type AnyCapability = typeof streamSignalsCapability | typeof addonSettingsCapability | typeof alertsCapability | typeof storageCapability | typeof storageMigrationCapability | typeof storageProviderCapability | typeof storageEvictableCapability | typeof storageOccupancyCapability | typeof filesystemBrowseCapability | typeof backupCapability | typeof terminalSessionCapability | typeof settingsStoreCapability | typeof dataStoreProviderCapability | typeof databaseSnapshotCapability | typeof migrationsCapability | typeof storageAdminCapability | typeof recordsCapability | typeof recordEntriesCapability | typeof deviceHistoryCapability | typeof deviceRunsCapability | typeof deviceTransitionsCapability | typeof timedRunCapability | typeof doNotDisturbCapability | typeof keychainCapability | typeof keychainAdminCapability | typeof deviceCredentialsCapability | typeof nodeCertificatesCapability | typeof logChannelsCapability | typeof logDestinationCapability | typeof loadContributionCapability | typeof failureContributionCapability | typeof deviceRemovalHookCapability | typeof nodeRemovalHookCapability | typeof adminUiCapability | typeof viewerUiCapability | typeof ssoBridgeCapability | typeof userPasskeysCapability | typeof smtpProviderCapability | typeof mqttBrokerCapability | typeof brokerCapability | typeof deviceAdoptionCapability | typeof deviceAdminLinkCapability | typeof deviceExportCapability | typeof addonPagesCapability | typeof addonPagesSourceCapability | typeof addonWidgetsCapability | typeof addonWidgetsSourceCapability | typeof customModelRegistryCapability | typeof modelDistributorCapability | typeof modelConvertCapability | typeof addonRoutesCapability | typeof streamBrokerCapability | typeof decoderCapability | typeof webrtcSessionCapability | typeof cameraStreamsCapability | typeof calendarSourceCapability | typeof calendarsCapability | typeof motionDetectionCapability | typeof pipelineExecutorCapability | typeof detectionPipelineCapability | typeof cameraPipelineConfigCapability | typeof pipelineRunnerCapability | typeof pipelineOrchestratorCapability | typeof audioAnalyzerCapability | typeof audioAnalysisCapability | typeof audioCodecCapability | typeof embeddingEncoderCapability | typeof vectorStoreCapability | typeof deviceProviderCapability | typeof deviceManagerCapability | typeof deviceStateCapability | typeof authProviderCapability | typeof loginMethodCapability | typeof networkAccessCapability | typeof boardKeySourceCapability | typeof turnProviderCapability | typeof snapshotCapability | typeof llmCapability | typeof llmRuntimeCapability | typeof notificationOutputCapability | typeof composerCapability | typeof coreBlocksCapability | typeof notificationRulesCapability | typeof pipelineAnalyticsCapability | typeof metricsProviderCapability | typeof ptzCapability | typeof ptzAutotrackCapability | typeof navigationCapability | typeof consumablesCapability | typeof runningStateCapability | typeof rebootCapability | typeof lowPowerSleepCapability | typeof resyncCapability | typeof brightnessCapability | typeof colorCapability | typeof climateControlCapability | typeof coverCapability | typeof valveCapability | typeof humidifierCapability | typeof waterHeaterCapability | typeof weatherCapability | typeof weatherStationCapability | typeof imageCapability | typeof lockControlCapability | typeof powerSourceCapability | typeof vacuumControlCapability | typeof petFeederCapability | typeof petFountainCapability | typeof pumpCycleCapability | typeof lawnMowerControlCapability | typeof fanControlCapability | typeof controlCapability | typeof notifierCapability | typeof mediaPlayerCapability | typeof meterCapability | typeof alarmPanelCapability | typeof presenceCapability | typeof scriptRunnerCapability | typeof actionSourceCapability | typeof actionsCapability | typeof schedulersCapability | typeof automationControlCapability | typeof motionTriggerCapability | typeof sirenCapability | typeof zonesCapability | typeof zoneRulesCapability | typeof trainingCapability | typeof trainingProviderCapability | typeof zoneAnalyticsCapability | typeof audioMetricsCapability | typeof motionCapability | typeof contactCapability | typeof floodCapability | typeof smokeCapability | typeof carbonMonoxideCapability | typeof gasCapability | typeof groupActiveCapability | typeof groupCommandsCapability | typeof groupStatusCapability | typeof tamperCapability | typeof vibrationCapability | typeof connectivityCapability | typeof binaryCapability | typeof temperatureSensorCapability | typeof heatingValveCapability | typeof heatPumpStatusCapability | typeof energySystemCapability | typeof workloadCapability | typeof heatPumpControlCapability | typeof humiditySensorCapability | typeof ambientLightSensorCapability | typeof pressureSensorCapability | typeof powerMeterCapability | typeof airQualitySensorCapability | typeof numericSensorCapability | typeof enumSensorCapability | typeof recordingCapability | typeof recordingArchiveCapability | typeof recordingExportCapability | typeof recordingSignalCapability | typeof deviceOpsCapability | typeof displayPaletteCapability | typeof platformProbeCapability | typeof localNetworkCapability | typeof meshNetworkCapability | typeof userManagementCapability | typeof systemCapability | typeof networkQualityCapability | typeof toastCapability | typeof nodesCapability | typeof serverManagementCapability | typeof clusterUpdateCapability | typeof integrationsCapability | typeof integrationInstancesCapability | typeof addonsCapability | typeof oauthIntegrationCapability | typeof streamParamsCapability | typeof streamCatalogCapability | typeof motionZonesCapability | typeof cameraGridLayoutCapability | typeof sceneMonitorCapability | typeof privacyMaskCapability | typeof dayNightCapability | typeof recordingOnboardCapability | typeof imageSettingsCapability | typeof osdCapability | typeof osdManagerCapability | typeof accessoriesCapability | typeof batteryCapability | typeof errorCapability | typeof networkLinkCapability | typeof buttonCapability | typeof irTransmitterCapability | typeof remoteCapability | typeof heroLayoutCapability | typeof fanPresetsCapability | typeof templateCapability | typeof tagsCapability | typeof remoteLayoutComponentsCapability | typeof cameraCredentialsCapability | typeof deviceStatusCapability | typeof doorbellCapability | typeof eventEmitterCapability | typeof faceGalleryCapability | typeof featureProbeCapability | typeof intercomCapability | typeof nativeObjectDetectionCapability | typeof plateGalleryCapability | typeof switchCapability | typeof updateCapability | typeof videoclipsCapability | typeof deviceExtensionCapability | typeof dishwasherCapability;
511
515
  export type CapabilityName = AnyCapability['name'];
512
516
  export type ITypedReadinessRegistry = IReadinessRegistry<CapabilityName>;
@@ -0,0 +1,83 @@
1
+ import { z } from 'zod';
2
+ import { type InferProvider } from './capability-definition.js';
3
+ import { DeviceType } from '../device/device-type.js';
4
+ /**
5
+ * low-power-sleep — a device that goes into low-power sleep and must be WOKEN
6
+ * before it streams (#459, Q2). A battery camera (Reolink Argus, a robot's
7
+ * on-board camera) is one; a battery SENSOR is not: it reports charge on the
8
+ * `battery` cap and never sleeps. The two meanings used to share
9
+ * `DeviceFeature.BatteryOperated`; this cap is the one that answers "sleeps",
10
+ * and `DeviceFeature.Sleeps` is derived from it being bound with
11
+ * `wakeUp` implemented.
12
+ *
13
+ * The state is the sleep inputs (`deriveBatteryPresence`): whether the device
14
+ * is asleep, and the last time it PROVED it was reachable. Read from this slice
15
+ * by the stream broker (`readBatterySleepFacts`), the recorder
16
+ * (`recordingWakeDeps`) and the snapshot builtin. The broker's per-device
17
+ * mirror is still also fed by `BatteryOnStatusChanged` events.
18
+ */
19
+ export declare const LowPowerSleepStatusSchema: z.ZodObject<{
20
+ sleeping: z.ZodBoolean;
21
+ lastContactAt: z.ZodOptional<z.ZodNumber>;
22
+ lastUpdated: z.ZodNumber;
23
+ }, z.core.$strip>;
24
+ export type LowPowerSleepStatus = z.infer<typeof LowPowerSleepStatusSchema>;
25
+ export declare const lowPowerSleepCapability: {
26
+ readonly name: 'low-power-sleep';
27
+ readonly scope: 'device';
28
+ readonly deviceNative: true;
29
+ readonly mode: 'singleton';
30
+ readonly deviceTypes: readonly [DeviceType.Camera];
31
+ readonly methods: {
32
+ /**
33
+ * Explicitly wake the device from low-power sleep ahead of a streaming
34
+ * session start. Consumers that initiate a stream against a sleeping
35
+ * camera (wake-on-play, the recorder, HomeKit, Alexa, snapshot wrappers)
36
+ * call this with a short timeout before establishing the media pipeline —
37
+ * the broker's own passive wake-on-dial works but adds 5–7 seconds to
38
+ * first-frame. Pre-waking compresses that gap.
39
+ *
40
+ * Returns `awoke: true` when the firmware acknowledged the wake before
41
+ * `timeoutMs`, `awoke: false` when it timed out; the caller should still
42
+ * attempt the stream — the passive broker wake remains as fallback.
43
+ */
44
+ readonly wakeUp: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
45
+ deviceId: z.ZodNumber;
46
+ timeoutMs: z.ZodDefault<z.ZodNumber>;
47
+ }, z.core.$strip>, z.ZodObject<{
48
+ awoke: z.ZodBoolean;
49
+ durationMs: z.ZodNumber;
50
+ }, z.core.$strip>, "mutation">;
51
+ };
52
+ readonly status: {
53
+ readonly schema: z.ZodObject<{
54
+ sleeping: z.ZodBoolean;
55
+ lastContactAt: z.ZodOptional<z.ZodNumber>;
56
+ lastUpdated: z.ZodNumber;
57
+ }, z.core.$strip>;
58
+ readonly kind: 'push';
59
+ readonly empty: {
60
+ readonly sleeping: false;
61
+ readonly lastUpdated: 0;
62
+ };
63
+ };
64
+ readonly runtimeState: z.ZodObject<{
65
+ sleeping: z.ZodBoolean;
66
+ lastContactAt: z.ZodOptional<z.ZodNumber>;
67
+ lastUpdated: z.ZodNumber;
68
+ }, z.core.$strip>;
69
+ /**
70
+ * Runtime-state durability: **restored** — a sleeping camera may not report
71
+ * for hours; the restored sleep inputs are the only thing the sleep gate and
72
+ * the presence derivation have (the same argument as `battery`).
73
+ */
74
+ readonly durability: 'restored';
75
+ /** History (D850): none — battery never recorded a sleep series either. */
76
+ readonly history: 'none';
77
+ readonly volatileStateFields: readonly ["lastUpdated"];
78
+ readonly vocabulary: {
79
+ readonly noun: import("../index.js").VocabL10n;
80
+ readonly order: 5245;
81
+ };
82
+ };
83
+ export type ILowPowerSleepProvider = InferProvider<typeof lowPowerSleepCapability>;
@@ -0,0 +1,40 @@
1
+ import { type InferProvider } from './capability-definition.js';
2
+ import { z } from 'zod';
3
+ import { DeviceType } from '../device/device-type.js';
4
+ /**
5
+ * resync — a device whose derived spec can be re-aligned on demand with its
6
+ * upstream source (#459, Q6). Registered by the containers an integration
7
+ * adopted; `DeviceFeature.Resyncable` (the generic Re-sync button) is derived
8
+ * from it being bound with `resync` implemented.
9
+ *
10
+ * The work itself stays where it is: the owning addon's `device-adoption`
11
+ * provider, reached through `deviceManager.adoptionResync` (which also owns
12
+ * the "resync from zero" child purge). A provider answers this method by
13
+ * asking for exactly that — see `resyncThroughAdoption`.
14
+ */
15
+ export declare const ResyncDeviceInputSchema: z.ZodObject<{
16
+ deviceId: z.ZodNumber;
17
+ resetToSource: z.ZodOptional<z.ZodBoolean>;
18
+ }, z.core.$strip>;
19
+ export declare const resyncCapability: {
20
+ readonly name: 'resync';
21
+ readonly scope: 'device';
22
+ readonly deviceNative: true;
23
+ readonly mode: 'singleton';
24
+ readonly deviceTypes: readonly [DeviceType.Container, DeviceType.Workload, DeviceType.WeatherStation];
25
+ readonly methods: {
26
+ readonly resync: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
27
+ deviceId: z.ZodNumber;
28
+ resetToSource: z.ZodOptional<z.ZodBoolean>;
29
+ }, z.core.$strip>, z.ZodObject<{
30
+ changed: z.ZodBoolean;
31
+ rebuiltChildren: z.ZodNumber;
32
+ removedChildren: z.ZodOptional<z.ZodNumber>;
33
+ }, z.core.$strip>, "mutation">;
34
+ };
35
+ readonly vocabulary: {
36
+ readonly noun: import("../index.js").VocabL10n;
37
+ readonly order: 3245;
38
+ };
39
+ };
40
+ export type IResyncProvider = InferProvider<typeof resyncCapability>;
package/dist/client.js CHANGED
@@ -27652,10 +27652,7 @@ function createDeviceProxy(api, binding, opts) {
27652
27652
  trigger: (input, options) => dispatch("automation-control", "automationControl", "trigger", "mutation", input, void 0, options),
27653
27653
  getStatus: (input, options) => dispatch("automation-control", "automationControl", "getStatus", "query", input, void 0, options)
27654
27654
  };
27655
- const batteryInterface = {
27656
- wakeForStream: (input, options) => dispatch("battery", "battery", "wakeForStream", "mutation", input, void 0, options),
27657
- getStatus: (input, options) => dispatch("battery", "battery", "getStatus", "query", input, void 0, options)
27658
- };
27655
+ const batteryInterface = { getStatus: (input, options) => dispatch("battery", "battery", "getStatus", "query", input, void 0, options) };
27659
27656
  const binaryInterface = { getStatus: (input, options) => dispatch("binary", "binary", "getStatus", "query", input, void 0, options) };
27660
27657
  const brightnessInterface = {
27661
27658
  setBrightness: (input, options) => dispatch("brightness", "brightness", "setBrightness", "mutation", input, void 0, options),
@@ -27859,6 +27856,10 @@ function createDeviceProxy(api, binding, opts) {
27859
27856
  open: (input, options) => dispatch("lock-control", "lockControl", "open", "mutation", input, void 0, options),
27860
27857
  getStatus: (input, options) => dispatch("lock-control", "lockControl", "getStatus", "query", input, void 0, options)
27861
27858
  };
27859
+ const lowPowerSleepInterface = {
27860
+ wakeUp: (input, options) => dispatch("low-power-sleep", "lowPowerSleep", "wakeUp", "mutation", input, void 0, options),
27861
+ getStatus: (input, options) => dispatch("low-power-sleep", "lowPowerSleep", "getStatus", "query", input, void 0, options)
27862
+ };
27862
27863
  const mediaPlayerInterface = {
27863
27864
  turnOn: (input, options) => dispatch("media-player", "mediaPlayer", "turnOn", "mutation", input, void 0, options),
27864
27865
  turnOff: (input, options) => dispatch("media-player", "mediaPlayer", "turnOff", "mutation", input, void 0, options),
@@ -28100,6 +28101,7 @@ function createDeviceProxy(api, binding, opts) {
28100
28101
  getStatus: (input, options) => dispatch("recording-onboard", "recordingOnboard", "getStatus", "query", input, void 0, options)
28101
28102
  };
28102
28103
  const recordingSignalInterface = { getStatus: (input, options) => dispatch("recording-signal", "recordingSignal", "getStatus", "query", input, void 0, options) };
28104
+ const resyncInterface = { resync: (input, options) => dispatch("resync", "resync", "resync", "mutation", input, void 0, options) };
28103
28105
  const runningStateInterface = { getStatus: (input, options) => dispatch("running-state", "runningState", "getStatus", "query", input, void 0, options) };
28104
28106
  const sceneMonitorInterface = {
28105
28107
  listScenes: (input, options) => dispatch("scene-monitor", "sceneMonitor", "listScenes", "query", input, void 0, options),
@@ -28457,6 +28459,7 @@ function createDeviceProxy(api, binding, opts) {
28457
28459
  irTransmitter: createSliceHandle(stateSource, binding.deviceId, "ir-transmitter"),
28458
28460
  lawnMowerControl: createSliceHandle(stateSource, binding.deviceId, "lawn-mower-control"),
28459
28461
  lockControl: createSliceHandle(stateSource, binding.deviceId, "lock-control"),
28462
+ lowPowerSleep: createSliceHandle(stateSource, binding.deviceId, "low-power-sleep"),
28460
28463
  mediaPlayer: createSliceHandle(stateSource, binding.deviceId, "media-player"),
28461
28464
  meter: createSliceHandle(stateSource, binding.deviceId, "meter"),
28462
28465
  motion: createSliceHandle(stateSource, binding.deviceId, "motion"),
@@ -28558,6 +28561,7 @@ function createDeviceProxy(api, binding, opts) {
28558
28561
  ...bound("ir-transmitter") ? { irTransmitter: irTransmitterInterface } : {},
28559
28562
  ...bound("lawn-mower-control") ? { lawnMowerControl: lawnMowerControlInterface } : {},
28560
28563
  ...bound("lock-control") ? { lockControl: lockControlInterface } : {},
28564
+ ...bound("low-power-sleep") ? { lowPowerSleep: lowPowerSleepInterface } : {},
28561
28565
  ...bound("media-player") ? { mediaPlayer: mediaPlayerInterface } : {},
28562
28566
  ...bound("meter") ? { meter: meterInterface } : {},
28563
28567
  ...bound("motion") ? { motion: motionInterface } : {},
@@ -28585,6 +28589,7 @@ function createDeviceProxy(api, binding, opts) {
28585
28589
  ...bound("recording") ? { recording: recordingInterface } : {},
28586
28590
  ...bound("recording-onboard") ? { recordingOnboard: recordingOnboardInterface } : {},
28587
28591
  ...bound("recording-signal") ? { recordingSignal: recordingSignalInterface } : {},
28592
+ ...bound("resync") ? { resync: resyncInterface } : {},
28588
28593
  ...bound("running-state") ? { runningState: runningStateInterface } : {},
28589
28594
  ...bound("scene-monitor") ? { sceneMonitor: sceneMonitorInterface } : {},
28590
28595
  ...bound("script-runner") ? { scriptRunner: scriptRunnerInterface } : {},
package/dist/client.mjs CHANGED
@@ -27651,10 +27651,7 @@ function createDeviceProxy(api, binding, opts) {
27651
27651
  trigger: (input, options) => dispatch("automation-control", "automationControl", "trigger", "mutation", input, void 0, options),
27652
27652
  getStatus: (input, options) => dispatch("automation-control", "automationControl", "getStatus", "query", input, void 0, options)
27653
27653
  };
27654
- const batteryInterface = {
27655
- wakeForStream: (input, options) => dispatch("battery", "battery", "wakeForStream", "mutation", input, void 0, options),
27656
- getStatus: (input, options) => dispatch("battery", "battery", "getStatus", "query", input, void 0, options)
27657
- };
27654
+ const batteryInterface = { getStatus: (input, options) => dispatch("battery", "battery", "getStatus", "query", input, void 0, options) };
27658
27655
  const binaryInterface = { getStatus: (input, options) => dispatch("binary", "binary", "getStatus", "query", input, void 0, options) };
27659
27656
  const brightnessInterface = {
27660
27657
  setBrightness: (input, options) => dispatch("brightness", "brightness", "setBrightness", "mutation", input, void 0, options),
@@ -27858,6 +27855,10 @@ function createDeviceProxy(api, binding, opts) {
27858
27855
  open: (input, options) => dispatch("lock-control", "lockControl", "open", "mutation", input, void 0, options),
27859
27856
  getStatus: (input, options) => dispatch("lock-control", "lockControl", "getStatus", "query", input, void 0, options)
27860
27857
  };
27858
+ const lowPowerSleepInterface = {
27859
+ wakeUp: (input, options) => dispatch("low-power-sleep", "lowPowerSleep", "wakeUp", "mutation", input, void 0, options),
27860
+ getStatus: (input, options) => dispatch("low-power-sleep", "lowPowerSleep", "getStatus", "query", input, void 0, options)
27861
+ };
27861
27862
  const mediaPlayerInterface = {
27862
27863
  turnOn: (input, options) => dispatch("media-player", "mediaPlayer", "turnOn", "mutation", input, void 0, options),
27863
27864
  turnOff: (input, options) => dispatch("media-player", "mediaPlayer", "turnOff", "mutation", input, void 0, options),
@@ -28099,6 +28100,7 @@ function createDeviceProxy(api, binding, opts) {
28099
28100
  getStatus: (input, options) => dispatch("recording-onboard", "recordingOnboard", "getStatus", "query", input, void 0, options)
28100
28101
  };
28101
28102
  const recordingSignalInterface = { getStatus: (input, options) => dispatch("recording-signal", "recordingSignal", "getStatus", "query", input, void 0, options) };
28103
+ const resyncInterface = { resync: (input, options) => dispatch("resync", "resync", "resync", "mutation", input, void 0, options) };
28102
28104
  const runningStateInterface = { getStatus: (input, options) => dispatch("running-state", "runningState", "getStatus", "query", input, void 0, options) };
28103
28105
  const sceneMonitorInterface = {
28104
28106
  listScenes: (input, options) => dispatch("scene-monitor", "sceneMonitor", "listScenes", "query", input, void 0, options),
@@ -28456,6 +28458,7 @@ function createDeviceProxy(api, binding, opts) {
28456
28458
  irTransmitter: createSliceHandle(stateSource, binding.deviceId, "ir-transmitter"),
28457
28459
  lawnMowerControl: createSliceHandle(stateSource, binding.deviceId, "lawn-mower-control"),
28458
28460
  lockControl: createSliceHandle(stateSource, binding.deviceId, "lock-control"),
28461
+ lowPowerSleep: createSliceHandle(stateSource, binding.deviceId, "low-power-sleep"),
28459
28462
  mediaPlayer: createSliceHandle(stateSource, binding.deviceId, "media-player"),
28460
28463
  meter: createSliceHandle(stateSource, binding.deviceId, "meter"),
28461
28464
  motion: createSliceHandle(stateSource, binding.deviceId, "motion"),
@@ -28557,6 +28560,7 @@ function createDeviceProxy(api, binding, opts) {
28557
28560
  ...bound("ir-transmitter") ? { irTransmitter: irTransmitterInterface } : {},
28558
28561
  ...bound("lawn-mower-control") ? { lawnMowerControl: lawnMowerControlInterface } : {},
28559
28562
  ...bound("lock-control") ? { lockControl: lockControlInterface } : {},
28563
+ ...bound("low-power-sleep") ? { lowPowerSleep: lowPowerSleepInterface } : {},
28560
28564
  ...bound("media-player") ? { mediaPlayer: mediaPlayerInterface } : {},
28561
28565
  ...bound("meter") ? { meter: meterInterface } : {},
28562
28566
  ...bound("motion") ? { motion: motionInterface } : {},
@@ -28584,6 +28588,7 @@ function createDeviceProxy(api, binding, opts) {
28584
28588
  ...bound("recording") ? { recording: recordingInterface } : {},
28585
28589
  ...bound("recording-onboard") ? { recordingOnboard: recordingOnboardInterface } : {},
28586
28590
  ...bound("recording-signal") ? { recordingSignal: recordingSignalInterface } : {},
28591
+ ...bound("resync") ? { resync: resyncInterface } : {},
28587
28592
  ...bound("running-state") ? { runningState: runningStateInterface } : {},
28588
28593
  ...bound("scene-monitor") ? { sceneMonitor: sceneMonitorInterface } : {},
28589
28594
  ...bound("script-runner") ? { scriptRunner: scriptRunnerInterface } : {},
@@ -139,12 +139,19 @@ var DeviceType = /* @__PURE__ */ function(DeviceType) {
139
139
  return DeviceType;
140
140
  }({});
141
141
  var DeviceFeature = /* @__PURE__ */ function(DeviceFeature) {
142
+ /** The device reports a battery reading (the `battery` cap). Says nothing about sleep. */
142
143
  DeviceFeature["BatteryOperated"] = "battery-operated";
144
+ /**
145
+ * The device goes into low-power sleep and must be WOKEN before it streams
146
+ * (the `low-power-sleep` cap, `wakeUp`). A battery reading alone is
147
+ * not this: a battery sensor reports charge and never sleeps (#459, Q2).
148
+ */
149
+ DeviceFeature["Sleeps"] = "sleeps";
143
150
  DeviceFeature["Rebootable"] = "rebootable";
144
151
  /**
145
152
  * Device supports an on-demand re-sync of its derived spec with its
146
- * upstream source — drives the generic Re-sync button. The owning
147
- * provider implements the action via the `device-adoption.resync` cap.
153
+ * upstream source — drives the generic Re-sync button. Present when the
154
+ * device has the `resync` cap bound (#459, Q6).
148
155
  */
149
156
  DeviceFeature["Resyncable"] = "resyncable";
150
157
  DeviceFeature["NativeSnapshot"] = "native-snapshot";
@@ -277,15 +284,9 @@ var DeviceFeature = /* @__PURE__ */ function(DeviceFeature) {
277
284
  /** Automation `trigger` accepts a skipCondition flag — fires the
278
285
  * automation's actions while bypassing its condition block. */
279
286
  DeviceFeature["AutomationSkipCondition"] = "automation-skip-condition";
280
- /** Robot vacuum exposes a live cleaning map (image child). Gates the
281
- * map tile in the vacuum UI. */
282
- DeviceFeature["VacuumHasMap"] = "vacuum-has-map";
283
287
  /** Robot vacuum exposes AI obstacle-detection toggles. Gates the AI
284
288
  * switches group. */
285
289
  DeviceFeature["VacuumHasAi"] = "vacuum-has-ai";
286
- /** Robot mower exposes a live mowing map (SVG image child). Gates the
287
- * mower map tile. */
288
- DeviceFeature["MowerHasMap"] = "mower-has-map";
289
290
  /** Robot mower exposes targeted mowing (all-area / zones / edges /
290
291
  * spots) — gates the Mow action + map selectors. */
291
292
  DeviceFeature["MowerHasTargetedMowing"] = "mower-has-targeted-mowing";
@@ -139,12 +139,19 @@ var DeviceType = /* @__PURE__ */ function(DeviceType) {
139
139
  return DeviceType;
140
140
  }({});
141
141
  var DeviceFeature = /* @__PURE__ */ function(DeviceFeature) {
142
+ /** The device reports a battery reading (the `battery` cap). Says nothing about sleep. */
142
143
  DeviceFeature["BatteryOperated"] = "battery-operated";
144
+ /**
145
+ * The device goes into low-power sleep and must be WOKEN before it streams
146
+ * (the `low-power-sleep` cap, `wakeUp`). A battery reading alone is
147
+ * not this: a battery sensor reports charge and never sleeps (#459, Q2).
148
+ */
149
+ DeviceFeature["Sleeps"] = "sleeps";
143
150
  DeviceFeature["Rebootable"] = "rebootable";
144
151
  /**
145
152
  * Device supports an on-demand re-sync of its derived spec with its
146
- * upstream source — drives the generic Re-sync button. The owning
147
- * provider implements the action via the `device-adoption.resync` cap.
153
+ * upstream source — drives the generic Re-sync button. Present when the
154
+ * device has the `resync` cap bound (#459, Q6).
148
155
  */
149
156
  DeviceFeature["Resyncable"] = "resyncable";
150
157
  DeviceFeature["NativeSnapshot"] = "native-snapshot";
@@ -277,15 +284,9 @@ var DeviceFeature = /* @__PURE__ */ function(DeviceFeature) {
277
284
  /** Automation `trigger` accepts a skipCondition flag — fires the
278
285
  * automation's actions while bypassing its condition block. */
279
286
  DeviceFeature["AutomationSkipCondition"] = "automation-skip-condition";
280
- /** Robot vacuum exposes a live cleaning map (image child). Gates the
281
- * map tile in the vacuum UI. */
282
- DeviceFeature["VacuumHasMap"] = "vacuum-has-map";
283
287
  /** Robot vacuum exposes AI obstacle-detection toggles. Gates the AI
284
288
  * switches group. */
285
289
  DeviceFeature["VacuumHasAi"] = "vacuum-has-ai";
286
- /** Robot mower exposes a live mowing map (SVG image child). Gates the
287
- * mower map tile. */
288
- DeviceFeature["MowerHasMap"] = "mower-has-map";
289
290
  /** Robot mower exposes targeted mowing (all-area / zones / edges /
290
291
  * spots) — gates the Mow action + map selectors. */
291
292
  DeviceFeature["MowerHasTargetedMowing"] = "mower-has-targeted-mowing";
@@ -33,9 +33,10 @@ export interface ReportedFeature {
33
33
  export type FeatureRequirement = CapBackedFeature | ReportedFeature;
34
34
  /** Exhaustive: a new `DeviceFeature` without a row does not compile. */
35
35
  export declare const DEVICE_FEATURE_REQUIREMENTS: {
36
- readonly "battery-operated": ReportedFeature;
36
+ readonly "battery-operated": CapBackedFeature;
37
+ readonly sleeps: CapBackedFeature;
37
38
  readonly rebootable: CapBackedFeature;
38
- readonly resyncable: ReportedFeature;
39
+ readonly resyncable: CapBackedFeature;
39
40
  readonly "native-snapshot": ReportedFeature;
40
41
  readonly "doorbell-button": CapBackedFeature;
41
42
  readonly "two-way-audio": CapBackedFeature;
@@ -83,9 +84,7 @@ export declare const DEVICE_FEATURE_REQUIREMENTS: {
83
84
  readonly "notifier-recipients": ReportedFeature;
84
85
  readonly "script-variables": ReportedFeature;
85
86
  readonly "automation-skip-condition": ReportedFeature;
86
- readonly "vacuum-has-map": ReportedFeature;
87
87
  readonly "vacuum-has-ai": ReportedFeature;
88
- readonly "mower-has-map": ReportedFeature;
89
88
  readonly "mower-has-targeted-mowing": ReportedFeature;
90
89
  readonly navigation: CapBackedFeature;
91
90
  readonly "network-link": CapBackedFeature;
@@ -128,7 +128,7 @@ export interface DeviceProfile {
128
128
  * shipped populated — `snapshot.minRefreshIntervalSec: 3600` and
129
129
  * `streamBroker.preBufferEnabled: false` on the battery profile — which read
130
130
  * as live policy and were not: both behaviours are really enforced off
131
- * `DeviceFeature.BatteryOperated` directly, by `BATTERY_DEFAULT_MAX_AGE_S`
131
+ * `DeviceFeature.Sleeps` directly, by `BATTERY_DEFAULT_MAX_AGE_S`
132
132
  * in `snapshot.addon.ts` and by `getEffectivePreBufferSec` in
133
133
  * `stream-broker-manager.ts`. Emptied 2026-08-07; keep it empty until a
134
134
  * reader exists, or an entry here is just documentation that lies.
@@ -125,12 +125,19 @@ export declare enum DeviceType {
125
125
  Workload = "workload"
126
126
  }
127
127
  export declare enum DeviceFeature {
128
+ /** The device reports a battery reading (the `battery` cap). Says nothing about sleep. */
128
129
  BatteryOperated = "battery-operated",
130
+ /**
131
+ * The device goes into low-power sleep and must be WOKEN before it streams
132
+ * (the `low-power-sleep` cap, `wakeUp`). A battery reading alone is
133
+ * not this: a battery sensor reports charge and never sleeps (#459, Q2).
134
+ */
135
+ Sleeps = "sleeps",
129
136
  Rebootable = "rebootable",
130
137
  /**
131
138
  * Device supports an on-demand re-sync of its derived spec with its
132
- * upstream source — drives the generic Re-sync button. The owning
133
- * provider implements the action via the `device-adoption.resync` cap.
139
+ * upstream source — drives the generic Re-sync button. Present when the
140
+ * device has the `resync` cap bound (#459, Q6).
134
141
  */
135
142
  Resyncable = "resyncable",
136
143
  NativeSnapshot = "native-snapshot",
@@ -263,15 +270,9 @@ export declare enum DeviceFeature {
263
270
  /** Automation `trigger` accepts a skipCondition flag — fires the
264
271
  * automation's actions while bypassing its condition block. */
265
272
  AutomationSkipCondition = "automation-skip-condition",
266
- /** Robot vacuum exposes a live cleaning map (image child). Gates the
267
- * map tile in the vacuum UI. */
268
- VacuumHasMap = "vacuum-has-map",
269
273
  /** Robot vacuum exposes AI obstacle-detection toggles. Gates the AI
270
274
  * switches group. */
271
275
  VacuumHasAi = "vacuum-has-ai",
272
- /** Robot mower exposes a live mowing map (SVG image child). Gates the
273
- * mower map tile. */
274
- MowerHasMap = "mower-has-map",
275
276
  /** Robot mower exposes targeted mowing (all-area / zones / edges /
276
277
  * spots) — gates the Mow action + map selectors. */
277
278
  MowerHasTargetedMowing = "mower-has-targeted-mowing",
@@ -0,0 +1,19 @@
1
+ import type { BatteryStatus } from '../capabilities/battery.cap.js';
2
+ import type { LowPowerSleepStatus } from '../capabilities/low-power-sleep.cap.js';
3
+ /**
4
+ * Does this device SLEEP and need waking before it streams (#459, Q2)?
5
+ *
6
+ * The one predicate every data-plane consumer asks (prebuffer, wake-on-play,
7
+ * the recorder, sentry, the snapshot wrapper, the detection profile). It reads
8
+ * `DeviceFeature.Sleeps`, derived from the `low-power-sleep` cap — never
9
+ * `DeviceFeature.BatteryOperated`, which only says the device reports a
10
+ * battery: a battery sensor reports charge and never sleeps.
11
+ */
12
+ export declare function deviceSleeps(features: readonly string[]): boolean;
13
+ /**
14
+ * The `low-power-sleep` slice a provider projects from the `battery` slice it
15
+ * already keeps: the sleep inputs, nothing else. One fact, one writer — the
16
+ * provider's battery bookkeeping stays the source until the sleep state gets
17
+ * its own writer.
18
+ */
19
+ export declare function sleepSliceOfBattery(status: BatteryStatus): LowPowerSleepStatus;
@@ -0,0 +1,12 @@
1
+ import type { AddonApi } from '../generated/addon-api.js';
2
+ import type { resyncCapability } from '../capabilities/resync.cap.js';
3
+ import type { InferNativeProvider } from '../capabilities/capability-definition.js';
4
+ /** The one deviceManager method a `resync` provider needs. */
5
+ export type AdoptionResyncClient = Pick<AddonApi['deviceManager'], 'adoptionResync'>;
6
+ /**
7
+ * The `resync` provider of an adopted container (#459, Q6): the work is the
8
+ * owning addon's `device-adoption.resync`, reached through
9
+ * `deviceManager.adoptionResync`, which also owns the "resync from zero" child
10
+ * purge. Registering this is what makes `DeviceFeature.Resyncable` true.
11
+ */
12
+ export declare function resyncThroughAdoption(deviceManager: AdoptionResyncClient, ownDeviceId: number): InferNativeProvider<typeof resyncCapability>;