@camstack/types 1.2.592 → 1.2.594

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 (43) hide show
  1. package/CHANGELOG.md +17 -0
  2. package/dist/addon.js +2 -2
  3. package/dist/addon.mjs +2 -2
  4. package/dist/capabilities/composer.cap.d.ts +9 -0
  5. package/dist/capabilities/core-blocks.cap.d.ts +64 -0
  6. package/dist/capabilities/device-manager.cap.d.ts +681 -48
  7. package/dist/capabilities/device-state-refresh.cap.d.ts +58 -0
  8. package/dist/capabilities/index.d.ts +3 -1
  9. package/dist/capabilities/power-source.cap.d.ts +10 -0
  10. package/dist/client.js +10 -0
  11. package/dist/client.mjs +10 -0
  12. package/dist/composition/composition-report.d.ts +3 -0
  13. package/dist/composition/composition.d.ts +14 -0
  14. package/dist/composition/power-source-link.d.ts +8 -0
  15. package/dist/device/base-device.d.ts +8 -0
  16. package/dist/device/command-hold.d.ts +6 -0
  17. package/dist/device/device-management.d.ts +4 -0
  18. package/dist/device/identity-links.d.ts +310 -0
  19. package/dist/device/index.d.ts +2 -0
  20. package/dist/device/state-refresh.d.ts +51 -0
  21. package/dist/enums/event-category.d.ts +14 -0
  22. package/dist/enums.js +1 -1
  23. package/dist/enums.mjs +1 -1
  24. package/dist/{event-category-CY27-fF0.mjs → event-category-7P4A3bYA.mjs} +14 -0
  25. package/dist/{event-category-BKxXXxnV.js → event-category-CMA0-jGW.js} +14 -0
  26. package/dist/generated/addon-api.d.ts +57 -0
  27. package/dist/generated/cap-vocabulary.d.ts +1 -1
  28. package/dist/generated/capability-router-map.d.ts +5 -2
  29. package/dist/generated/device-proxy.d.ts +3 -1
  30. package/dist/generated/device-scoped-caps.d.ts +1 -1
  31. package/dist/generated/method-access-map.d.ts +1 -1
  32. package/dist/generated/method-device-selectors.d.ts +2 -2
  33. package/dist/generated/system-proxy.d.ts +1 -1
  34. package/dist/{implemented-methods-k3KProJd.mjs → implemented-methods-DXeNAPAS.mjs} +11 -2
  35. package/dist/{implemented-methods-BarLh7tc.js → implemented-methods-Dj_2fX8-.js} +16 -1
  36. package/dist/index.d.ts +3 -0
  37. package/dist/index.js +442 -12
  38. package/dist/index.mjs +416 -13
  39. package/dist/node.js +1 -1
  40. package/dist/node.mjs +1 -1
  41. package/dist/{sleep-D2Ny6tvi.js → sleep-Bgzv_TCG.js} +23 -3
  42. package/dist/{sleep-dgC2VKW4.mjs → sleep-C9eelFbV.mjs} +23 -3
  43. package/package.json +1 -1
@@ -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>;
@@ -32,6 +32,8 @@ export declare const POWER_SOURCE_OFF_SECONDS_MIN = 3;
32
32
  export declare const POWER_SOURCE_OFF_SECONDS_MAX = 120;
33
33
  export declare const POWER_SOURCE_OFF_SECONDS_DEFAULT = 10;
34
34
  export declare const PowerSourceRefusalReasonSchema: z.ZodEnum<{
35
+ "link-lost": "link-lost";
36
+ "link-unknown": "link-unknown";
35
37
  "no-power-source": "no-power-source";
36
38
  "not-settable": "not-settable";
37
39
  "restart-in-progress": "restart-in-progress";
@@ -48,6 +50,8 @@ export declare const PowerSourceActionResultSchema: z.ZodDiscriminatedUnion<[z.Z
48
50
  }, z.core.$strip>, z.ZodObject<{
49
51
  accepted: z.ZodLiteral<false>;
50
52
  reason: z.ZodEnum<{
53
+ "link-lost": "link-lost";
54
+ "link-unknown": "link-unknown";
51
55
  "no-power-source": "no-power-source";
52
56
  "not-settable": "not-settable";
53
57
  "restart-in-progress": "restart-in-progress";
@@ -111,6 +115,8 @@ export declare const powerSourceCapability: {
111
115
  }, z.core.$strip>, z.ZodObject<{
112
116
  accepted: z.ZodLiteral<false>;
113
117
  reason: z.ZodEnum<{
118
+ "link-lost": "link-lost";
119
+ "link-unknown": "link-unknown";
114
120
  "no-power-source": "no-power-source";
115
121
  "not-settable": "not-settable";
116
122
  "restart-in-progress": "restart-in-progress";
@@ -132,6 +138,8 @@ export declare const powerSourceCapability: {
132
138
  }, z.core.$strip>, z.ZodObject<{
133
139
  accepted: z.ZodLiteral<false>;
134
140
  reason: z.ZodEnum<{
141
+ "link-lost": "link-lost";
142
+ "link-unknown": "link-unknown";
135
143
  "no-power-source": "no-power-source";
136
144
  "not-settable": "not-settable";
137
145
  "restart-in-progress": "restart-in-progress";
@@ -153,6 +161,8 @@ export declare const powerSourceCapability: {
153
161
  }, z.core.$strip>, z.ZodObject<{
154
162
  accepted: z.ZodLiteral<false>;
155
163
  reason: z.ZodEnum<{
164
+ "link-lost": "link-lost";
165
+ "link-unknown": "link-unknown";
156
166
  "no-power-source": "no-power-source";
157
167
  "not-settable": "not-settable";
158
168
  "restart-in-progress": "restart-in-progress";
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),
@@ -28334,6 +28338,8 @@ function createDeviceProxy(api, binding, opts) {
28334
28338
  applyInitialMeta: (input, options) => dispatchSystem("deviceManager", "applyInitialMeta", "mutation", input, void 0, options),
28335
28339
  setMetadata: (input, options) => dispatchSystem("deviceManager", "setMetadata", "mutation", input, void 0, options),
28336
28340
  setIdentifiers: (input, options) => dispatchSystem("deviceManager", "setIdentifiers", "mutation", input, void 0, options),
28341
+ setAttachedIdentifiers: (input, options) => dispatchSystem("deviceManager", "setAttachedIdentifiers", "mutation", input, void 0, options),
28342
+ listIdentityLinks: (input, options) => dispatchSystem("deviceManager", "listIdentityLinks", "query", input, void 0, options),
28337
28343
  setDisabled: (input, options) => dispatchSystem("deviceManager", "setDisabled", "mutation", input, void 0, options),
28338
28344
  getDevice: (input, options) => dispatchSystem("deviceManager", "getDevice", "query", input, void 0, options),
28339
28345
  getLinkedDevices: (input, options) => dispatchSystem("deviceManager", "getLinkedDevices", "query", input, void 0, options),
@@ -28582,6 +28588,7 @@ function createDeviceProxy(api, binding, opts) {
28582
28588
  ...bound("device-extension") ? { deviceExtension: deviceExtensionInterface } : {},
28583
28589
  ...bound("device-ops") ? { deviceOps: deviceOpsInterface } : {},
28584
28590
  ...bound("device-runs") ? { deviceRuns: deviceRunsInterface } : {},
28591
+ ...bound("device-state-refresh") ? { deviceStateRefresh: deviceStateRefreshInterface } : {},
28585
28592
  ...bound("device-status") ? { deviceStatus: deviceStatusInterface } : {},
28586
28593
  ...bound("device-transitions") ? { deviceTransitions: deviceTransitionsInterface } : {},
28587
28594
  ...bound("dishwasher") ? { dishwasher: dishwasherInterface } : {},
@@ -29584,6 +29591,9 @@ function createSystemProxy(api) {
29584
29591
  getRoleDisplayDefaults: (input) => dispatch("deviceManager", "getRoleDisplayDefaults", "query", input),
29585
29592
  setRoleDisplayDefaults: (input) => dispatch("deviceManager", "setRoleDisplayDefaults", "mutation", input),
29586
29593
  listIdentityCandidates: (input) => dispatch("deviceManager", "listIdentityCandidates", "query", input),
29594
+ confirmIdentityLink: (input) => dispatch("deviceManager", "confirmIdentityLink", "mutation", input),
29595
+ dismissIdentityLink: (input) => dispatch("deviceManager", "dismissIdentityLink", "mutation", input),
29596
+ unlinkIdentity: (input) => dispatch("deviceManager", "unlinkIdentity", "mutation", input),
29587
29597
  listLocations: (input) => dispatch("deviceManager", "listLocations", "query", input),
29588
29598
  addLocation: (input) => dispatch("deviceManager", "addLocation", "mutation", input),
29589
29599
  removeLocation: (input) => dispatch("deviceManager", "removeLocation", "mutation", input),
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),
@@ -28333,6 +28337,8 @@ function createDeviceProxy(api, binding, opts) {
28333
28337
  applyInitialMeta: (input, options) => dispatchSystem("deviceManager", "applyInitialMeta", "mutation", input, void 0, options),
28334
28338
  setMetadata: (input, options) => dispatchSystem("deviceManager", "setMetadata", "mutation", input, void 0, options),
28335
28339
  setIdentifiers: (input, options) => dispatchSystem("deviceManager", "setIdentifiers", "mutation", input, void 0, options),
28340
+ setAttachedIdentifiers: (input, options) => dispatchSystem("deviceManager", "setAttachedIdentifiers", "mutation", input, void 0, options),
28341
+ listIdentityLinks: (input, options) => dispatchSystem("deviceManager", "listIdentityLinks", "query", input, void 0, options),
28336
28342
  setDisabled: (input, options) => dispatchSystem("deviceManager", "setDisabled", "mutation", input, void 0, options),
28337
28343
  getDevice: (input, options) => dispatchSystem("deviceManager", "getDevice", "query", input, void 0, options),
28338
28344
  getLinkedDevices: (input, options) => dispatchSystem("deviceManager", "getLinkedDevices", "query", input, void 0, options),
@@ -28581,6 +28587,7 @@ function createDeviceProxy(api, binding, opts) {
28581
28587
  ...bound("device-extension") ? { deviceExtension: deviceExtensionInterface } : {},
28582
28588
  ...bound("device-ops") ? { deviceOps: deviceOpsInterface } : {},
28583
28589
  ...bound("device-runs") ? { deviceRuns: deviceRunsInterface } : {},
28590
+ ...bound("device-state-refresh") ? { deviceStateRefresh: deviceStateRefreshInterface } : {},
28584
28591
  ...bound("device-status") ? { deviceStatus: deviceStatusInterface } : {},
28585
28592
  ...bound("device-transitions") ? { deviceTransitions: deviceTransitionsInterface } : {},
28586
28593
  ...bound("dishwasher") ? { dishwasher: dishwasherInterface } : {},
@@ -29583,6 +29590,9 @@ function createSystemProxy(api) {
29583
29590
  getRoleDisplayDefaults: (input) => dispatch("deviceManager", "getRoleDisplayDefaults", "query", input),
29584
29591
  setRoleDisplayDefaults: (input) => dispatch("deviceManager", "setRoleDisplayDefaults", "mutation", input),
29585
29592
  listIdentityCandidates: (input) => dispatch("deviceManager", "listIdentityCandidates", "query", input),
29593
+ confirmIdentityLink: (input) => dispatch("deviceManager", "confirmIdentityLink", "mutation", input),
29594
+ dismissIdentityLink: (input) => dispatch("deviceManager", "dismissIdentityLink", "mutation", input),
29595
+ unlinkIdentity: (input) => dispatch("deviceManager", "unlinkIdentity", "mutation", input),
29586
29596
  listLocations: (input) => dispatch("deviceManager", "listLocations", "query", input),
29587
29597
  addLocation: (input) => dispatch("deviceManager", "addLocation", "mutation", input),
29588
29598
  removeLocation: (input) => dispatch("deviceManager", "removeLocation", "mutation", input),
@@ -15,6 +15,7 @@ export declare const CompositionProblemCodeSchema: z.ZodEnum<{
15
15
  "helper-mismatch": "helper-mismatch";
16
16
  "item-field-reserved": "item-field-reserved";
17
17
  "kind-mismatch": "kind-mismatch";
18
+ "link-contribution-removed": "link-contribution-removed";
18
19
  "may-be-null": "may-be-null";
19
20
  "member-constraint": "member-constraint";
20
21
  "missing-field": "missing-field";
@@ -53,6 +54,7 @@ export declare const CompositionProblemSchema: z.ZodObject<{
53
54
  "helper-mismatch": "helper-mismatch";
54
55
  "item-field-reserved": "item-field-reserved";
55
56
  "kind-mismatch": "kind-mismatch";
57
+ "link-contribution-removed": "link-contribution-removed";
56
58
  "may-be-null": "may-be-null";
57
59
  "member-constraint": "member-constraint";
58
60
  "missing-field": "missing-field";
@@ -281,6 +283,7 @@ export declare const CompositionValidationSchema: z.ZodObject<{
281
283
  "helper-mismatch": "helper-mismatch";
282
284
  "item-field-reserved": "item-field-reserved";
283
285
  "kind-mismatch": "kind-mismatch";
286
+ "link-contribution-removed": "link-contribution-removed";
284
287
  "may-be-null": "may-be-null";
285
288
  "member-constraint": "member-constraint";
286
289
  "missing-field": "missing-field";
@@ -414,6 +414,11 @@ export declare const CompositionItemEntrySchema: z.ZodObject<{
414
414
  }, z.core.$strip>>;
415
415
  }, z.core.$strip>;
416
416
  export type CompositionItemEntry = z.infer<typeof CompositionItemEntrySchema>;
417
+ /** Which identity link added a feature (D1063). */
418
+ export declare const CompositionContributedBySchema: z.ZodObject<{
419
+ linkId: z.ZodString;
420
+ }, z.core.$strip>;
421
+ export type CompositionContributedBy = z.infer<typeof CompositionContributedBySchema>;
417
422
  export declare const CompositionFieldsFeatureSchema: z.ZodObject<{
418
423
  kind: z.ZodLiteral<"fields">;
419
424
  cap: z.ZodString;
@@ -605,6 +610,9 @@ export declare const CompositionFieldsFeatureSchema: z.ZodObject<{
605
610
  kind: z.ZodLiteral<"extension">;
606
611
  target: z.ZodLiteral<"remote">;
607
612
  }, z.core.$strip>], "kind">>>;
613
+ contributedBy: z.ZodOptional<z.ZodObject<{
614
+ linkId: z.ZodString;
615
+ }, z.core.$strip>>;
608
616
  }, z.core.$strip>;
609
617
  export type CompositionFieldsFeature = z.infer<typeof CompositionFieldsFeatureSchema>;
610
618
  /** RESERVED for slice 3: a media / data-plane cap, whole, from one source. */
@@ -809,6 +817,9 @@ export declare const CompositionFeatureSchema: z.ZodDiscriminatedUnion<[z.ZodObj
809
817
  kind: z.ZodLiteral<"extension">;
810
818
  target: z.ZodLiteral<"remote">;
811
819
  }, z.core.$strip>], "kind">>>;
820
+ contributedBy: z.ZodOptional<z.ZodObject<{
821
+ linkId: z.ZodString;
822
+ }, z.core.$strip>>;
812
823
  }, z.core.$strip>, z.ZodObject<{
813
824
  kind: z.ZodLiteral<"passthrough">;
814
825
  cap: z.ZodString;
@@ -1063,6 +1074,9 @@ export declare const CompositionSchema: z.ZodObject<{
1063
1074
  kind: z.ZodLiteral<"extension">;
1064
1075
  target: z.ZodLiteral<"remote">;
1065
1076
  }, z.core.$strip>], "kind">>>;
1077
+ contributedBy: z.ZodOptional<z.ZodObject<{
1078
+ linkId: z.ZodString;
1079
+ }, z.core.$strip>>;
1066
1080
  }, z.core.$strip>, z.ZodObject<{
1067
1081
  kind: z.ZodLiteral<"passthrough">;
1068
1082
  cap: z.ZodString;
@@ -7,6 +7,14 @@ export interface PowerSourceLink {
7
7
  readonly switch: CompositionSourceRef;
8
8
  /** How long a forced restart keeps the switch off: an integer within the cap's bounds. */
9
9
  readonly offSeconds: number;
10
+ /**
11
+ * The identity link that contributed this feature (D1063), or absent when the
12
+ * operator wrote it. A contributed link is re-checked against that link before
13
+ * any action: a stamp is not proof the port still feeds this device.
14
+ */
15
+ readonly contributedBy?: {
16
+ readonly linkId: string;
17
+ };
10
18
  }
11
19
  /**
12
20
  * The stored off time, or the default when none is stored. A stored number out
@@ -183,6 +183,14 @@ export declare abstract class BaseDevice<T extends z.ZodObject<z.core.$ZodLooseS
183
183
  * nothing. Best-effort: never throws.
184
184
  */
185
185
  protected declareIdentifiers(raw: RawDeviceIdentifiers, options?: DeclareIdentifiersOptions): Promise<DeclareIdentifiersResult>;
186
+ /**
187
+ * Declare the identity of the device at the FAR END of this device's physical
188
+ * link (D1063): a PoE port's wired client. Same normalisation, `unread`
189
+ * rule and owner check as {@link declareIdentifiers}, written through
190
+ * `device-manager.setAttachedIdentifiers`. It never makes the two devices the
191
+ * same device. Best-effort: never throws.
192
+ */
193
+ protected declareAttachedIdentifiers(raw: RawDeviceIdentifiers, options?: DeclareIdentifiersOptions): Promise<DeclareIdentifiersResult>;
186
194
  /**
187
195
  * Re-publish the device's current `features` array to the persisted
188
196
  * meta blob. Drivers call this after a probe finishes when the live
@@ -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 {
@@ -164,6 +164,10 @@ export interface DeviceMeta {
164
164
  * the owning provider through `device-manager.setIdentifiers`, read-only for
165
165
  * the operator. Absent ⇒ the provider declared none. */
166
166
  readonly identifiers?: DeviceIdentifiers;
167
+ /** The identity of the device at the far end of this device's physical link
168
+ * (D1063) — a PoE port's wired client. Written only by the owning provider
169
+ * through `device-manager.setAttachedIdentifiers`. Absent ⇒ none declared. */
170
+ readonly attachedIdentifiers?: DeviceIdentifiers;
167
171
  /** Optional upstream-system identity + rendering envelope. See
168
172
  * `SourceInfo`. Persisted under `metadata.sourceInfo` — this field
169
173
  * is the typed projection callers consume directly. `BaseDevice`