@camstack/types 1.2.592 → 1.2.593

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/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.593] - 2026-11-18
11
+
12
+ ### Added
13
+
14
+ - New device-state-refresh capability and state-refresh policy types: a provider declares how its devices are read, the hub decides when (D1062).
15
+
10
16
  ## [1.2.592] - 2026-11-18
11
17
 
12
18
  ### Changed
package/dist/addon.js CHANGED
@@ -1,5 +1,5 @@
1
1
  Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
2
- const require_sleep = require("./sleep-D2Ny6tvi.js");
2
+ const require_sleep = require("./sleep-BOK28JE0.js");
3
3
  const require_event_category = require("./event-category-BKxXXxnV.js");
4
4
  const require_composed_stable_id = require("./composed-stable-id-BdeYe5dD.js");
5
5
  //#region src/generated/cap-input-defaults.ts
package/dist/addon.mjs CHANGED
@@ -1,4 +1,4 @@
1
- import { $ as viewerUiCapability, $i as asRecordsError, $n as RecordIndexSchema, Ai as isSecretRef, An as resolveSecretViewsIn, B as CALLER_STAMPED_CAPABILITIES, Bi as InvalidRecordError, Bn as PEER_BYTES_CHUNK_BYTES, Ca as isSecretClear, Ci as RECORD_SETTINGS_MAX_ROWS, Cn as OnBehalfSchema, Ct as ReadinessTimeoutError, Da as makeSecretMarker, Di as buildSecretRef, Dn as makeInMemoryRecords, Ea as isSecretMarkerLike, Ei as arrayItemFieldPath, En as ruleFireOfClaim, Er as ErrorI18nPayloadSchema, Et as scopeKey, F as CAP_METHOD_TIMEOUTS_MS, Fn as forgetKnownSecret, Gi as RecordSecretUnavailableError, Gn as CALLER_USERNAME_HEADER, Gr as nodeIdOfScopedKey, H as customAction, Hi as PlaintextSecretError, Hn as PEER_BYTES_STALL_MS, Ia as AddonMigrationsBlockedError, Ii as BatchTooLargeError, In as knownSecretCount, J as commandOrigin, Ji as RecordsError, Jn as DisposerChain, Ki as RecordTooLargeError, Kn as DATAPLANE_SECRET_HEADER, Kr as resolveDeviceSettings, L as CAP_STATE_LEAVES, La as findMigrationsBlocked, Li as DeclarationRefusedError, Ln as registerKnownSecret, M as HF_REPO, Mi as parseSecretRef, Mn as createSecretsAccess, Nn as MIN_SCRUBBED_LENGTH, O as isCommand, Oa as toSecretFieldView, Oi as formatSecretScope, On as createRecordsAccess, P as CAP_ADVANCE_FIELDS, Pn as clearKnownSecrets, Pr as normalizeAddonInitResult, Pt as createDebugEmitter, Qi as UnknownRecordKindError, Qn as RecordFieldPathSchema, R as CAP_METHOD_NOT_IMPLEMENTED, Ri as FilterRequiredError, Rn as scrubKnownSecrets, Sa as classifySecretWrite, Si as RECORD_SECRET_COLLECTION_PREFIX, Sn as CommandOriginClaimSchema, St as ReadinessRegistry, Ta as isSecretMarker, Ti as SECRET_REF_SCHEME, Tn as RuleFireOriginSchema, U as defineCustomActions, Ui as RECORDS_ERROR_CODES, Un as PEER_BYTES_TICKET_TTL_MS, V as withoutCallerStamp, Vi as NoCallerError, Vn as PEER_BYTES_MAX_OUTSTANDING, W as describeCustomActions, Wi as RecordNotFoundError, Wr as SCOPED_SETTINGS_SCOPES, X as readCommandOrigin, Xi as TransactRefusedError, Xn as entryBody, Y as nodePin, Yi as RevConflictError, Yn as defineEntryKind, Z as readNodePin, Zi as UnindexedFilterError, Zn as EntryDescriptorSchema, _i as RECORD_ID_MAX_LENGTH, _r as expandCapMethods, ai as mapSecretLeaves, ar as declarationsOf, bi as RECORD_MAX_INDEX_FIELDS, c as asString, ci as recordSecretCollection, cr as collectZodSecretPaths, ct as adminUiCapability, d as parseJsonUnknown, da as emitReadiness, di as RECORD_BATCH_MAX, ea as recordsErrorFromMessage, er as RecordKindDeclarationSchema, et as SWITCH_SETTABLE_GATE, f as hfModelUrl, fi as RECORD_BATCH_MAX_BYTES, g as createDeviceProxy, gi as RECORD_DELETE_BATCH, h as isDeviceScopedCap, hi as RECORD_DEFAULT_MAX_DATA_BYTES, ii as collectSecretLeaves, ir as assertValidDeclaration, it as MIGRATION_API_VERSION, ji as normalizeSecretOwner, jn as REVALIDATE_AFTER_MS, jr as BaseAddon, ki as globalSecretScope, kn as assertTransactScope, kr as readErrorI18n, li as recordSecretRef, lr as isZodSecret, m as DEVICE_SCOPED_CAPS, mi as RECORD_DATABASES, ni as secretViewsOf, nr as RecordRetentionSchema, nt as PipelineRunResultBridge, o as asJsonObject, oi as parseSecretPath, or as defineRecordKinds, ot as deviceOpsCapability, p as BOOT_RECOVERY_BACKOFF_MS, pi as RECORD_CLASSES, qi as RecordUniqueViolationError, qr as resolvedValues, r as maskUrlCredentials, ri as REMOVE_LEAF, rr as StoredRecordKindDeclarationSchema, rt as PipelineStepInputSchema, si as recordArrayItemPath, st as DEVICE_CHILDREN_BATCH_MAX, t as sleep, tr as RecordKindNameSchema, tt as switchRefusesSetState, ua as createEvent, ui as secretArrayPrefixes, ut as addonPagesSourceCapability, v as addonSliceHandleApi, vi as RECORD_MAX_DATA_BYTES, wa as isSecretFieldView, wi as RECORD_SWEEP_INTERVAL_MS, wn as OnBehalfSourceSchema, xa as SECRET_CLEAR, xi as RECORD_QUERY_MAX, xt as MODEL_FORMATS, y as createEventBusSliceSource, yi as RECORD_MAX_INDEXES, z as isCapMethodAbsent, zi as ForeignSecretMarkerError, zn as shortSecretRefHash } from "./sleep-dgC2VKW4.mjs";
1
+ import { $ as viewerUiCapability, $i as asRecordsError, $n as RecordIndexSchema, Ai as isSecretRef, An as resolveSecretViewsIn, B as CALLER_STAMPED_CAPABILITIES, Bi as InvalidRecordError, Bn as PEER_BYTES_CHUNK_BYTES, Ca as isSecretClear, Ci as RECORD_SETTINGS_MAX_ROWS, Cn as OnBehalfSchema, Ct as ReadinessTimeoutError, Da as makeSecretMarker, Di as buildSecretRef, Dn as makeInMemoryRecords, Ea as isSecretMarkerLike, Ei as arrayItemFieldPath, En as ruleFireOfClaim, Er as ErrorI18nPayloadSchema, Et as scopeKey, F as CAP_METHOD_TIMEOUTS_MS, Fn as forgetKnownSecret, Gi as RecordSecretUnavailableError, Gn as CALLER_USERNAME_HEADER, Gr as nodeIdOfScopedKey, H as customAction, Hi as PlaintextSecretError, Hn as PEER_BYTES_STALL_MS, Ia as AddonMigrationsBlockedError, Ii as BatchTooLargeError, In as knownSecretCount, J as commandOrigin, Ji as RecordsError, Jn as DisposerChain, Ki as RecordTooLargeError, Kn as DATAPLANE_SECRET_HEADER, Kr as resolveDeviceSettings, L as CAP_STATE_LEAVES, La as findMigrationsBlocked, Li as DeclarationRefusedError, Ln as registerKnownSecret, M as HF_REPO, Mi as parseSecretRef, Mn as createSecretsAccess, Nn as MIN_SCRUBBED_LENGTH, O as isCommand, Oa as toSecretFieldView, Oi as formatSecretScope, On as createRecordsAccess, P as CAP_ADVANCE_FIELDS, Pn as clearKnownSecrets, Pr as normalizeAddonInitResult, Pt as createDebugEmitter, Qi as UnknownRecordKindError, Qn as RecordFieldPathSchema, R as CAP_METHOD_NOT_IMPLEMENTED, Ri as FilterRequiredError, Rn as scrubKnownSecrets, Sa as classifySecretWrite, Si as RECORD_SECRET_COLLECTION_PREFIX, Sn as CommandOriginClaimSchema, St as ReadinessRegistry, Ta as isSecretMarker, Ti as SECRET_REF_SCHEME, Tn as RuleFireOriginSchema, U as defineCustomActions, Ui as RECORDS_ERROR_CODES, Un as PEER_BYTES_TICKET_TTL_MS, V as withoutCallerStamp, Vi as NoCallerError, Vn as PEER_BYTES_MAX_OUTSTANDING, W as describeCustomActions, Wi as RecordNotFoundError, Wr as SCOPED_SETTINGS_SCOPES, X as readCommandOrigin, Xi as TransactRefusedError, Xn as entryBody, Y as nodePin, Yi as RevConflictError, Yn as defineEntryKind, Z as readNodePin, Zi as UnindexedFilterError, Zn as EntryDescriptorSchema, _i as RECORD_ID_MAX_LENGTH, _r as expandCapMethods, ai as mapSecretLeaves, ar as declarationsOf, bi as RECORD_MAX_INDEX_FIELDS, c as asString, ci as recordSecretCollection, cr as collectZodSecretPaths, ct as adminUiCapability, d as parseJsonUnknown, da as emitReadiness, di as RECORD_BATCH_MAX, ea as recordsErrorFromMessage, er as RecordKindDeclarationSchema, et as SWITCH_SETTABLE_GATE, f as hfModelUrl, fi as RECORD_BATCH_MAX_BYTES, g as createDeviceProxy, gi as RECORD_DELETE_BATCH, h as isDeviceScopedCap, hi as RECORD_DEFAULT_MAX_DATA_BYTES, ii as collectSecretLeaves, ir as assertValidDeclaration, it as MIGRATION_API_VERSION, ji as normalizeSecretOwner, jn as REVALIDATE_AFTER_MS, jr as BaseAddon, ki as globalSecretScope, kn as assertTransactScope, kr as readErrorI18n, li as recordSecretRef, lr as isZodSecret, m as DEVICE_SCOPED_CAPS, mi as RECORD_DATABASES, ni as secretViewsOf, nr as RecordRetentionSchema, nt as PipelineRunResultBridge, o as asJsonObject, oi as parseSecretPath, or as defineRecordKinds, ot as deviceOpsCapability, p as BOOT_RECOVERY_BACKOFF_MS, pi as RECORD_CLASSES, qi as RecordUniqueViolationError, qr as resolvedValues, r as maskUrlCredentials, ri as REMOVE_LEAF, rr as StoredRecordKindDeclarationSchema, rt as PipelineStepInputSchema, si as recordArrayItemPath, st as DEVICE_CHILDREN_BATCH_MAX, t as sleep, tr as RecordKindNameSchema, tt as switchRefusesSetState, ua as createEvent, ui as secretArrayPrefixes, ut as addonPagesSourceCapability, v as addonSliceHandleApi, vi as RECORD_MAX_DATA_BYTES, wa as isSecretFieldView, wi as RECORD_SWEEP_INTERVAL_MS, wn as OnBehalfSourceSchema, xa as SECRET_CLEAR, xi as RECORD_QUERY_MAX, xt as MODEL_FORMATS, y as createEventBusSliceSource, yi as RECORD_MAX_INDEXES, z as isCapMethodAbsent, zi as ForeignSecretMarkerError, zn as shortSecretRefHash } from "./sleep-DO-ayTnk.mjs";
2
2
  import { t as EventCategory } from "./event-category-CY27-fF0.mjs";
3
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
@@ -0,0 +1,58 @@
1
+ import { z } from 'zod';
2
+ import { type InferProvider } from './capability-definition.js';
3
+ /**
4
+ * device-state-refresh — the HOW of a device's state refresh, called by the
5
+ * core, which owns the WHEN (D1062).
6
+ *
7
+ * The provider registers it per device with its policy
8
+ * (`registerNativeCap(cap, provider, { stateRefresh })`). The hub's scheduler
9
+ * calls `refresh` on the schedule, after a command and in the burst that
10
+ * follows it, and `resubscribe` when a push integration fell silent. The
11
+ * provider re-reads and writes the slices it already writes; nothing is
12
+ * returned but completion.
13
+ */
14
+ export declare const DeviceStateRefreshInputSchema: z.ZodObject<{
15
+ deviceId: z.ZodNumber;
16
+ deviceIds: z.ZodArray<z.ZodNumber>;
17
+ reason: z.ZodEnum<{
18
+ burst: "burst";
19
+ command: "command";
20
+ schedule: "schedule";
21
+ }>;
22
+ }, z.core.$strip>;
23
+ export type DeviceStateRefreshInput = z.infer<typeof DeviceStateRefreshInputSchema>;
24
+ export declare const DeviceStateResubscribeInputSchema: z.ZodObject<{
25
+ deviceId: z.ZodNumber;
26
+ }, z.core.$strip>;
27
+ export declare const DeviceStateRefreshResultSchema: z.ZodObject<{
28
+ ok: z.ZodLiteral<true>;
29
+ }, z.core.$strip>;
30
+ export declare const deviceStateRefreshCapability: {
31
+ readonly name: 'device-state-refresh';
32
+ readonly scope: 'device';
33
+ readonly deviceNative: true;
34
+ readonly mode: 'singleton';
35
+ readonly methods: {
36
+ readonly refresh: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
37
+ deviceId: z.ZodNumber;
38
+ deviceIds: z.ZodArray<z.ZodNumber>;
39
+ reason: z.ZodEnum<{
40
+ burst: "burst";
41
+ command: "command";
42
+ schedule: "schedule";
43
+ }>;
44
+ }, z.core.$strip>, z.ZodObject<{
45
+ ok: z.ZodLiteral<true>;
46
+ }, z.core.$strip>, "mutation">;
47
+ readonly resubscribe: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
48
+ deviceId: z.ZodNumber;
49
+ }, z.core.$strip>, z.ZodObject<{
50
+ ok: z.ZodLiteral<true>;
51
+ }, z.core.$strip>, "mutation">;
52
+ };
53
+ readonly vocabulary: {
54
+ readonly noun: import("../index.js").VocabL10n;
55
+ readonly order: 3247;
56
+ };
57
+ };
58
+ export type IDeviceStateRefreshProvider = InferProvider<typeof deviceStateRefreshCapability>;
@@ -261,6 +261,7 @@ export { type IRunningStateProvider, type RunningStateSource, RunningStateSource
261
261
  export { type IRebootProvider, rebootCapability } from './reboot.cap.js';
262
262
  export { type ILowPowerSleepProvider, type LowPowerSleepStatus, LowPowerSleepStatusSchema, lowPowerSleepCapability, } from './low-power-sleep.cap.js';
263
263
  export { type IResyncProvider, ResyncDeviceInputSchema, resyncCapability } from './resync.cap.js';
264
+ export { type DeviceStateRefreshInput, DeviceStateRefreshInputSchema, DeviceStateRefreshResultSchema, DeviceStateResubscribeInputSchema, deviceStateRefreshCapability, type IDeviceStateRefreshProvider, } from './device-state-refresh.cap.js';
264
265
  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';
265
266
  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';
266
267
  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';
@@ -463,6 +464,7 @@ import type { runningStateCapability } from './running-state.cap.js';
463
464
  import type { rebootCapability } from './reboot.cap.js';
464
465
  import type { lowPowerSleepCapability } from './low-power-sleep.cap.js';
465
466
  import type { resyncCapability } from './resync.cap.js';
467
+ import type { deviceStateRefreshCapability } from './device-state-refresh.cap.js';
466
468
  import type { recordingCapability } from './recording.cap.js';
467
469
  import type { recordingArchiveCapability } from './recording-archive.cap.js';
468
470
  import type { recordingExportCapability } from './recording-export.cap.js';
@@ -511,6 +513,6 @@ import type { trainingProviderCapability } from './training-provider.cap.js';
511
513
  import type { zoneAnalyticsCapability } from './zone-analytics.cap.js';
512
514
  import type { zoneRulesCapability } from './zone-rules.cap.js';
513
515
  import type { zonesCapability } from './zones.cap.js';
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;
516
+ 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 deviceStateRefreshCapability | 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;
515
517
  export type CapabilityName = AnyCapability['name'];
516
518
  export type ITypedReadinessRegistry = IReadinessRegistry<CapabilityName>;
package/dist/client.js CHANGED
@@ -27799,6 +27799,10 @@ function createDeviceProxy(api, binding, opts) {
27799
27799
  getRun: (input, options) => dispatch("device-runs", "deviceRuns", "getRun", "query", input, void 0, options),
27800
27800
  getCurrentRun: (input, options) => dispatch("device-runs", "deviceRuns", "getCurrentRun", "query", input, void 0, options)
27801
27801
  };
27802
+ const deviceStateRefreshInterface = {
27803
+ refresh: (input, options) => dispatch("device-state-refresh", "deviceStateRefresh", "refresh", "mutation", input, void 0, options),
27804
+ resubscribe: (input, options) => dispatch("device-state-refresh", "deviceStateRefresh", "resubscribe", "mutation", input, void 0, options)
27805
+ };
27802
27806
  const deviceStatusInterface = { getStatus: (input, options) => dispatch("device-status", "deviceStatus", "getStatus", "query", input, void 0, options) };
27803
27807
  const deviceTransitionsInterface = {
27804
27808
  listTransitions: (input, options) => dispatch("device-transitions", "deviceTransitions", "listTransitions", "query", input, void 0, options),
@@ -28582,6 +28586,7 @@ function createDeviceProxy(api, binding, opts) {
28582
28586
  ...bound("device-extension") ? { deviceExtension: deviceExtensionInterface } : {},
28583
28587
  ...bound("device-ops") ? { deviceOps: deviceOpsInterface } : {},
28584
28588
  ...bound("device-runs") ? { deviceRuns: deviceRunsInterface } : {},
28589
+ ...bound("device-state-refresh") ? { deviceStateRefresh: deviceStateRefreshInterface } : {},
28585
28590
  ...bound("device-status") ? { deviceStatus: deviceStatusInterface } : {},
28586
28591
  ...bound("device-transitions") ? { deviceTransitions: deviceTransitionsInterface } : {},
28587
28592
  ...bound("dishwasher") ? { dishwasher: dishwasherInterface } : {},
package/dist/client.mjs CHANGED
@@ -27798,6 +27798,10 @@ function createDeviceProxy(api, binding, opts) {
27798
27798
  getRun: (input, options) => dispatch("device-runs", "deviceRuns", "getRun", "query", input, void 0, options),
27799
27799
  getCurrentRun: (input, options) => dispatch("device-runs", "deviceRuns", "getCurrentRun", "query", input, void 0, options)
27800
27800
  };
27801
+ const deviceStateRefreshInterface = {
27802
+ refresh: (input, options) => dispatch("device-state-refresh", "deviceStateRefresh", "refresh", "mutation", input, void 0, options),
27803
+ resubscribe: (input, options) => dispatch("device-state-refresh", "deviceStateRefresh", "resubscribe", "mutation", input, void 0, options)
27804
+ };
27801
27805
  const deviceStatusInterface = { getStatus: (input, options) => dispatch("device-status", "deviceStatus", "getStatus", "query", input, void 0, options) };
27802
27806
  const deviceTransitionsInterface = {
27803
27807
  listTransitions: (input, options) => dispatch("device-transitions", "deviceTransitions", "listTransitions", "query", input, void 0, options),
@@ -28581,6 +28585,7 @@ function createDeviceProxy(api, binding, opts) {
28581
28585
  ...bound("device-extension") ? { deviceExtension: deviceExtensionInterface } : {},
28582
28586
  ...bound("device-ops") ? { deviceOps: deviceOpsInterface } : {},
28583
28587
  ...bound("device-runs") ? { deviceRuns: deviceRunsInterface } : {},
28588
+ ...bound("device-state-refresh") ? { deviceStateRefresh: deviceStateRefreshInterface } : {},
28584
28589
  ...bound("device-status") ? { deviceStatus: deviceStatusInterface } : {},
28585
28590
  ...bound("device-transitions") ? { deviceTransitions: deviceTransitionsInterface } : {},
28586
28591
  ...bound("dishwasher") ? { dishwasher: dishwasherInterface } : {},
@@ -12,6 +12,7 @@
12
12
  import type { CapabilityDefinition } from '../capabilities/capability-definition.js';
13
13
  import { type CommandEffect, type CommandSlice } from './cap-vocabulary/command-catalog.js';
14
14
  import type { LooseVocabSideEffect } from './cap-vocabulary/types.js';
15
+ import type { StateRefreshPolicy } from './state-refresh.js';
15
16
  /**
16
17
  * How long a command is held when nothing says otherwise. Equal to the
17
18
  * transition correlator's match window (D1022), so a hold that reverts and a
@@ -39,6 +40,11 @@ export type CommandHoldOptions = Readonly<Record<string, CommandHoldOption>>;
39
40
  /** The options `registerNativeCap` takes, method names checked against the cap. */
40
41
  export interface NativeCapOptions<TCap extends CapabilityDefinition = CapabilityDefinition> {
41
42
  readonly commands?: Partial<Readonly<Record<keyof TCap['methods'] & string, CommandHoldOption>>>;
43
+ /**
44
+ * The device's refresh policy (D1062). Read only on the `device-state-refresh`
45
+ * registration: the core schedules that device's refreshes by it.
46
+ */
47
+ readonly stateRefresh?: StateRefreshPolicy;
42
48
  }
43
49
  /** What the core holds for one command: the fields and the limit. */
44
50
  export interface ResolvedCommandHold {
@@ -0,0 +1,51 @@
1
+ /**
2
+ * Server-driven device state refresh (D1062): the core decides WHEN a device is
3
+ * re-read, the integration only knows HOW.
4
+ *
5
+ * A provider states its policy where it registers the device's
6
+ * `device-state-refresh` cap (`ctx.registerNativeCap(cap, provider, {
7
+ * stateRefresh })`). It reaches the hub by the road the command-hold options
8
+ * take (D1061): written directly in-process, carried on a forked child's cap
9
+ * descriptors otherwise. Plain data, wire-safe.
10
+ */
11
+ import { z } from 'zod';
12
+ /** Why the core asks for a refresh. */
13
+ export declare const StateRefreshReasonSchema: z.ZodEnum<{
14
+ burst: "burst";
15
+ command: "command";
16
+ schedule: "schedule";
17
+ }>;
18
+ export type StateRefreshReason = z.infer<typeof StateRefreshReasonSchema>;
19
+ /**
20
+ * What arrives without asking: `none` (everything is read), `partial` (some
21
+ * fields arrive by push, the rest is read on the schedule), `full` (everything
22
+ * arrives by push — never read on a schedule).
23
+ */
24
+ export declare const StateRefreshPushSchema: z.ZodEnum<{
25
+ full: "full";
26
+ none: "none";
27
+ partial: "partial";
28
+ }>;
29
+ export type StateRefreshPush = z.infer<typeof StateRefreshPushSchema>;
30
+ /** The fastest base cadence the core accepts from any provider. */
31
+ export declare const MIN_STATE_REFRESH_INTERVAL_MS = 1000;
32
+ export declare const StateRefreshPolicySchema: z.ZodObject<{
33
+ integrationId: z.ZodString;
34
+ minIntervalMs: z.ZodNumber;
35
+ intervalMs: z.ZodOptional<z.ZodNumber>;
36
+ batch: z.ZodBoolean;
37
+ push: z.ZodEnum<{
38
+ full: "full";
39
+ none: "none";
40
+ partial: "partial";
41
+ }>;
42
+ heartbeatMs: z.ZodOptional<z.ZodNumber>;
43
+ connectionEpoch: z.ZodOptional<z.ZodNumber>;
44
+ }, z.core.$strip>;
45
+ export type StateRefreshPolicy = z.infer<typeof StateRefreshPolicySchema>;
46
+ /** The cadence the core runs a policy at: the declared minimum, slowed (never sped up) by the setting. */
47
+ export declare function effectiveRefreshIntervalMs(policy: StateRefreshPolicy): number;
48
+ /** The burst after a command on a read (non-push) device: offsets from the command, in ms. */
49
+ export declare const COMMAND_BURST_OFFSETS_MS: readonly number[];
50
+ /** How long the core waits for a push device to confirm a command before reading it once. */
51
+ export declare const PUSH_CONFIRM_WINDOW_MS = 2500;
@@ -53,6 +53,7 @@ import type { deviceOpsCapability } from '../capabilities/device-ops.cap.js';
53
53
  import type { deviceProviderCapability } from '../capabilities/device-provider.cap.js';
54
54
  import type { deviceRemovalHookCapability } from '../capabilities/device-removal-hook.cap.js';
55
55
  import type { deviceRunsCapability } from '../capabilities/device-runs.cap.js';
56
+ import type { deviceStateRefreshCapability } from '../capabilities/device-state-refresh.cap.js';
56
57
  import type { deviceStateCapability } from '../capabilities/device-state.cap.js';
57
58
  import type { deviceTransitionsCapability } from '../capabilities/device-transitions.cap.js';
58
59
  import type { dishwasherCapability } from '../capabilities/dishwasher.cap.js';
@@ -3660,6 +3661,27 @@ export type AppRouter = TrpcCoreRouter<{
3660
3661
  meta: object;
3661
3662
  }>;
3662
3663
  }>>;
3664
+ deviceStateRefresh: TRPCBuiltRouter<{
3665
+ ctx: TrpcContext;
3666
+ meta: object;
3667
+ errorShape: AugmentedErrorShape;
3668
+ transformer: true;
3669
+ }, TRPCDecorateCreateRouterOptions<{
3670
+ refresh: TRPCMutationProcedure<{
3671
+ input: {
3672
+ [x: string]: unknown;
3673
+ } & z.input<typeof deviceStateRefreshCapability.methods.refresh.input>;
3674
+ output: z.infer<typeof deviceStateRefreshCapability.methods.refresh.output>;
3675
+ meta: object;
3676
+ }>;
3677
+ resubscribe: TRPCMutationProcedure<{
3678
+ input: {
3679
+ [x: string]: unknown;
3680
+ } & z.input<typeof deviceStateRefreshCapability.methods.resubscribe.input>;
3681
+ output: z.infer<typeof deviceStateRefreshCapability.methods.resubscribe.output>;
3682
+ meta: object;
3683
+ }>;
3684
+ }>>;
3663
3685
  deviceStatus: TRPCBuiltRouter<{
3664
3686
  ctx: TrpcContext;
3665
3687
  meta: object;
@@ -1,7 +1,7 @@
1
1
  import type { CapVocabularyMap } from '../device/cap-vocabulary/types.js';
2
2
  /**
3
3
  * THE cap vocabulary (D920), projected from the declarations of every
4
- * `*.cap.ts` (D1050): 213 caps (111 device, 102 system).
4
+ * `*.cap.ts` (D1050): 214 caps (112 device, 102 system).
5
5
  * Device caps in their declared picker order, then system caps by name.
6
6
  */
7
7
  export declare const CAP_VOCABULARY: CapVocabularyMap;
@@ -61,6 +61,7 @@ export { deviceProviderCapability } from '../capabilities/device-provider.cap.js
61
61
  export { deviceRemovalHookCapability } from '../capabilities/device-removal-hook.cap.js';
62
62
  export { deviceRunsCapability } from '../capabilities/device-runs.cap.js';
63
63
  export { deviceStateCapability } from '../capabilities/device-state.cap.js';
64
+ export { deviceStateRefreshCapability } from '../capabilities/device-state-refresh.cap.js';
64
65
  export { deviceStatusCapability } from '../capabilities/device-status.cap.js';
65
66
  export { deviceTransitionsCapability } from '../capabilities/device-transitions.cap.js';
66
67
  export { dishwasherCapability } from '../capabilities/dishwasher.cap.js';
@@ -275,6 +276,7 @@ export declare const CAPABILITY_NAMES: {
275
276
  readonly deviceRemovalHook: 'device-removal-hook';
276
277
  readonly deviceRuns: 'device-runs';
277
278
  readonly deviceState: 'device-state';
279
+ readonly deviceStateRefresh: 'device-state-refresh';
278
280
  readonly deviceStatus: 'device-status';
279
281
  readonly deviceTransitions: 'device-transitions';
280
282
  readonly dishwasher: 'dishwasher';
@@ -502,6 +504,7 @@ export interface CapabilityRouterMap<TRouter = unknown> {
502
504
  readonly deviceRemovalHook: TRouter;
503
505
  readonly deviceRuns: TRouter;
504
506
  readonly deviceState: TRouter;
507
+ readonly deviceStateRefresh: TRouter;
505
508
  readonly deviceStatus: TRouter;
506
509
  readonly deviceTransitions: TRouter;
507
510
  readonly dishwasher: TRouter;
@@ -653,8 +656,8 @@ export interface CapabilityRouterMap<TRouter = unknown> {
653
656
  readonly zoneRules: TRouter;
654
657
  readonly zones: TRouter;
655
658
  }
656
- /** Capability names whose mode is `singleton` (173 caps). */
657
- export declare const SINGLETON_CAPABILITY_NAMES: readonly ['accessories', 'actions', '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', 'calendars', 'camera-credentials', 'camera-grid-layout', 'camera-pipeline-config', 'camera-streams', 'carbon-monoxide', 'climate-control', 'cluster-update', 'color', 'composer', 'connectivity', 'consumables', 'contact', 'control', 'core-blocks', 'cover', 'database-snapshot', 'day-night', 'decoder', 'detection-pipeline', 'device-admin-link', 'device-credentials', 'device-history', 'device-manager', 'device-ops', 'device-runs', 'device-state', 'device-status', 'device-transitions', 'dishwasher', 'display-palette', 'do-not-disturb', 'doorbell', 'energy-system', 'enum-sensor', 'error', 'event-emitter', 'face-gallery', 'fan-control', 'fan-presets', 'feature-probe', 'filesystem-browse', 'flood', 'gas', 'group-active', 'group-commands', 'group-status', 'heat-pump-control', 'heat-pump-status', 'heating-valve', 'hero-layout', 'humidifier', 'humidity-sensor', 'image', 'image-settings', 'integrations', 'intercom', 'ir-transmitter', 'keychain', 'keychain-admin', 'lawn-mower-control', 'llm-runtime', 'local-network', 'lock-control', 'low-power-sleep', 'media-player', 'meter', 'metrics-provider', 'migrations', 'model-convert', 'model-distributor', 'motion', 'motion-detection', 'motion-trigger', 'motion-zones', 'native-object-detection', 'navigation', 'network-link', 'network-quality', 'node-certificates', 'nodes', 'notification-rules', 'notifier', 'numeric-sensor', 'osd', 'osd-manager', 'pet-feeder', 'pet-fountain', 'pipeline-analytics', 'pipeline-executor', 'pipeline-orchestrator', 'pipeline-runner', 'plate-gallery', 'platform-probe', 'power-meter', 'power-source', 'presence', 'pressure-sensor', 'privacy-mask', 'ptz', 'ptz-autotrack', 'pump-cycle', 'reboot', 'record-entries', 'recording-archive', 'recording-export', 'recording-onboard', 'recording-signal', 'records', 'remote', 'resync', 'running-state', 'scene-monitor', 'schedulers', 'script-runner', 'server-management', 'settings-store', 'siren', 'smoke', 'snapshot', 'sso-bridge', 'storage', 'storage-admin', 'storage-migration', 'stream-broker', 'stream-catalog', 'stream-params', 'stream-signals', 'switch', 'system', 'tags', 'tamper', 'temperature-sensor', 'terminal-session', 'timed-run', 'toast', 'training', 'update', 'user-management', 'vacuum-control', 'valve', 'vector-store', 'vibration', 'viewer-ui', 'water-heater', 'weather', 'weather-station', 'webrtc-session', 'workload', 'zone-analytics', 'zone-rules', 'zones'];
659
+ /** Capability names whose mode is `singleton` (174 caps). */
660
+ export declare const SINGLETON_CAPABILITY_NAMES: readonly ['accessories', 'actions', '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', 'calendars', 'camera-credentials', 'camera-grid-layout', 'camera-pipeline-config', 'camera-streams', 'carbon-monoxide', 'climate-control', 'cluster-update', 'color', 'composer', 'connectivity', 'consumables', 'contact', 'control', 'core-blocks', 'cover', 'database-snapshot', 'day-night', 'decoder', 'detection-pipeline', 'device-admin-link', 'device-credentials', 'device-history', 'device-manager', 'device-ops', 'device-runs', 'device-state', 'device-state-refresh', 'device-status', 'device-transitions', 'dishwasher', 'display-palette', 'do-not-disturb', 'doorbell', 'energy-system', 'enum-sensor', 'error', 'event-emitter', 'face-gallery', 'fan-control', 'fan-presets', 'feature-probe', 'filesystem-browse', 'flood', 'gas', 'group-active', 'group-commands', 'group-status', 'heat-pump-control', 'heat-pump-status', 'heating-valve', 'hero-layout', 'humidifier', 'humidity-sensor', 'image', 'image-settings', 'integrations', 'intercom', 'ir-transmitter', 'keychain', 'keychain-admin', 'lawn-mower-control', 'llm-runtime', 'local-network', 'lock-control', 'low-power-sleep', 'media-player', 'meter', 'metrics-provider', 'migrations', 'model-convert', 'model-distributor', 'motion', 'motion-detection', 'motion-trigger', 'motion-zones', 'native-object-detection', 'navigation', 'network-link', 'network-quality', 'node-certificates', 'nodes', 'notification-rules', 'notifier', 'numeric-sensor', 'osd', 'osd-manager', 'pet-feeder', 'pet-fountain', 'pipeline-analytics', 'pipeline-executor', 'pipeline-orchestrator', 'pipeline-runner', 'plate-gallery', 'platform-probe', 'power-meter', 'power-source', 'presence', 'pressure-sensor', 'privacy-mask', 'ptz', 'ptz-autotrack', 'pump-cycle', 'reboot', 'record-entries', 'recording-archive', 'recording-export', 'recording-onboard', 'recording-signal', 'records', 'remote', 'resync', 'running-state', 'scene-monitor', 'schedulers', 'script-runner', 'server-management', 'settings-store', 'siren', 'smoke', 'snapshot', 'sso-bridge', 'storage', 'storage-admin', 'storage-migration', 'stream-broker', 'stream-catalog', 'stream-params', 'stream-signals', 'switch', 'system', 'tags', 'tamper', 'temperature-sensor', 'terminal-session', 'timed-run', 'toast', 'training', 'update', 'user-management', 'vacuum-control', 'valve', 'vector-store', 'vibration', 'viewer-ui', 'water-heater', 'weather', 'weather-station', 'webrtc-session', 'workload', 'zone-analytics', 'zone-rules', 'zones'];
658
661
  /** Union of singleton capability names (literal string union). */
659
662
  export type SingletonCapabilityName = typeof SINGLETON_CAPABILITY_NAMES[number];
660
663
  /** Capability names whose mode is `collection` (40 caps). */
@@ -31,6 +31,7 @@ import type { deviceAdminLinkCapability } from '../capabilities/device-admin-lin
31
31
  import type { deviceExtensionCapability } from '../capabilities/device-extension.cap.js';
32
32
  import type { deviceOpsCapability } from '../capabilities/device-ops.cap.js';
33
33
  import type { deviceRunsCapability } from '../capabilities/device-runs.cap.js';
34
+ import type { deviceStateRefreshCapability } from '../capabilities/device-state-refresh.cap.js';
34
35
  import type { deviceStatusCapability } from '../capabilities/device-status.cap.js';
35
36
  import type { deviceTransitionsCapability } from '../capabilities/device-transitions.cap.js';
36
37
  import type { dishwasherCapability } from '../capabilities/dishwasher.cap.js';
@@ -275,6 +276,7 @@ export interface DeviceProxy {
275
276
  readonly deviceExtension?: InferDeviceProxyCap<typeof deviceExtensionCapability>;
276
277
  readonly deviceOps?: InferDeviceProxyCap<typeof deviceOpsCapability>;
277
278
  readonly deviceRuns?: InferDeviceProxyCap<typeof deviceRunsCapability>;
279
+ readonly deviceStateRefresh?: InferDeviceProxyCap<typeof deviceStateRefreshCapability>;
278
280
  readonly deviceStatus?: InferDeviceProxyCap<typeof deviceStatusCapability>;
279
281
  readonly deviceTransitions?: InferDeviceProxyCap<typeof deviceTransitionsCapability>;
280
282
  readonly dishwasher?: InferDeviceProxyCap<typeof dishwasherCapability>;
@@ -5,7 +5,7 @@
5
5
  * can answer "may a rule actuate this?" without importing the schema barrel
6
6
  * (~144MB RSS per runner, D28).
7
7
  *
8
- * Coverage: 111 device-scoped capabilities.
8
+ * Coverage: 112 device-scoped capabilities.
9
9
  */
10
10
  export declare const DEVICE_SCOPED_CAPS: ReadonlySet<string>;
11
11
  /**
@@ -6,7 +6,7 @@
6
6
  * scope+access check inside `protectedProcedure` (see
7
7
  * `server/backend/src/api/trpc/trpc.middleware.ts`).
8
8
  *
9
- * Coverage: 1522 method paths across 213 capabilities.
9
+ * Coverage: 1524 method paths across 214 capabilities.
10
10
  */
11
11
  import type { MethodRole } from '../auth/viewer-access.js';
12
12
  import type { CapabilityMethodAccess } from '../capabilities/capability-definition.js';
@@ -6,7 +6,7 @@
6
6
  * system-scope cap that takes a deviceId was previously never device-filtered
7
7
  * — see the generator header).
8
8
  *
9
- * Coverage: 643 methods carry a device reference, of which
9
+ * Coverage: 645 methods carry a device reference, of which
10
10
  * 199 are on SYSTEM-scope caps.
11
11
  *
12
12
  * Top-level fields, number arrays, and one-level arrays of objects carrying
package/dist/index.d.ts CHANGED
@@ -493,4 +493,5 @@ export * from './migrations/api/migration-api-ports.js';
493
493
  export { normalizeSearchText, searchRank, type SearchRankFields } from './search/search-match.js';
494
494
  export { DEFAULT_COMMAND_HOLD_MS, MAX_COMMAND_HOLD_MS, resolveCommandHold, } from './device/command-hold.js';
495
495
  export { ONE_SHOT_HOLD_MS } from './device/cap-vocabulary/hold-limits.js';
496
+ export { COMMAND_BURST_OFFSETS_MS, effectiveRefreshIntervalMs, MIN_STATE_REFRESH_INTERVAL_MS, PUSH_CONFIRM_WINDOW_MS, type StateRefreshPolicy, StateRefreshPolicySchema, type StateRefreshPush, StateRefreshPushSchema, type StateRefreshReason, StateRefreshReasonSchema, } from './device/state-refresh.js';
496
497
  export type { CommandHoldOption, CommandHoldOptions, NativeCapOptions, ResolvedCommandHold, } from './device/command-hold.js';