@camstack/types 1.2.591 → 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.
@@ -0,0 +1,60 @@
1
+ /**
2
+ * The command hold (D1061): the core shows a commanded value at once, by
3
+ * default, until the device confirms it, the call is refused, or the limit
4
+ * elapses. The vocabulary says WHAT a command leads to (`effect`,
5
+ * `sideEffects`); a provider may say, at its registration, that a method is
6
+ * never held, held longer or shorter, or leads to other fields. Never in a
7
+ * `*.cap.ts` or a manifest (D4).
8
+ *
9
+ * Pure: the resolution below reads the vocabulary and the option only, so the
10
+ * hub mirror and a spec ask the same question.
11
+ */
12
+ import type { CapabilityDefinition } from '../capabilities/capability-definition.js';
13
+ import { type CommandEffect, type CommandSlice } from './cap-vocabulary/command-catalog.js';
14
+ import type { LooseVocabSideEffect } from './cap-vocabulary/types.js';
15
+ import type { StateRefreshPolicy } from './state-refresh.js';
16
+ /**
17
+ * How long a command is held when nothing says otherwise. Equal to the
18
+ * transition correlator's match window (D1022), so a hold that reverts and a
19
+ * command recorded `unconfirmed` are the same event.
20
+ */
21
+ export declare const DEFAULT_COMMAND_HOLD_MS = 30000;
22
+ /** The longest hold a provider may ask for: a value the device never confirms is not shown for long. */
23
+ export declare const MAX_COMMAND_HOLD_MS = 120000;
24
+ /** A provider's word on one command method. */
25
+ export type CommandHoldOption =
26
+ /** Never held: the slice moves only when the device reports. */
27
+ {
28
+ readonly hold: 'never';
29
+ } | {
30
+ readonly hold?: undefined;
31
+ /** The limit, in ms (clamped to 1 … {@link MAX_COMMAND_HOLD_MS}); absent = {@link DEFAULT_COMMAND_HOLD_MS}. */
32
+ readonly holdMs?: number;
33
+ /** REPLACES the vocabulary's effects for this method. */
34
+ readonly effects?: readonly LooseVocabSideEffect[];
35
+ /** Held IN ADDITION to the vocabulary's effects (a field already named keeps the first). */
36
+ readonly extraEffects?: readonly LooseVocabSideEffect[];
37
+ };
38
+ /** A provider's options, keyed by cap method name. Wire-safe (plain data). */
39
+ export type CommandHoldOptions = Readonly<Record<string, CommandHoldOption>>;
40
+ /** The options `registerNativeCap` takes, method names checked against the cap. */
41
+ export interface NativeCapOptions<TCap extends CapabilityDefinition = CapabilityDefinition> {
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;
48
+ }
49
+ /** What the core holds for one command: the fields and the limit. */
50
+ export interface ResolvedCommandHold {
51
+ readonly effects: readonly CommandEffect[];
52
+ readonly holdMs: number;
53
+ }
54
+ /**
55
+ * What to hold for `cap.method(args)` given the cap's slice when it arrived
56
+ * (`current`, as the device reported it; `shown`, with the held values over
57
+ * it — what a `negate` flips) and the provider's option for the method.
58
+ * `null` = hold nothing (`never`, or a command that leads to no state).
59
+ */
60
+ export declare function resolveCommandHold(cap: string, method: string, args: Readonly<Record<string, unknown>> | undefined, current: CommandSlice, option: CommandHoldOption | undefined, shown?: CommandSlice): ResolvedCommandHold | null;
@@ -7,6 +7,7 @@ import type { AddonApi } from '../generated/addon-api.js';
7
7
  import type { DeviceProxy } from '../generated/device-proxy.js';
8
8
  import type { DeviceMeta, InitialDeviceMeta } from './device-management.js';
9
9
  import type { DeviceType } from './device-type.js';
10
+ import type { NativeCapOptions } from './command-hold.js';
10
11
  /** What a device states about the config it persists. */
11
12
  export interface DevicePersistConfigOptions {
12
13
  /** Dotted paths its schema declares secret (`collectZodSecretPaths`). */
@@ -105,8 +106,10 @@ export interface DeviceContext {
105
106
  */
106
107
  readonly streamProbe?: IKernelStreamProbe;
107
108
  /** Register a native provider for `cap` on the device this context belongs to.
108
- * Multiple calls for the same cap throw. */
109
- registerNativeCap<TCap extends CapabilityDefinition>(cap: TCap, provider: InferNativeProvider<TCap>): void;
109
+ * Multiple calls for the same cap throw. `options.commands` overrides the
110
+ * core's command hold per method (D1061): `{ hold: 'never' }`, another
111
+ * `holdMs`, or other effects — absent = the core default. */
112
+ registerNativeCap<TCap extends CapabilityDefinition>(cap: TCap, provider: InferNativeProvider<TCap>, options?: NativeCapOptions<TCap>): void;
110
113
  /**
111
114
  * Remove the native provider THIS context registered for `capName` (D663: the composer ungrafts an added cap when a
112
115
  * foreign native appears or the target is gone). OPTIONAL on the published interface: every `DeviceContext` fake in the
@@ -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
@@ -272,8 +272,8 @@ export type { AccessoryControlInput, AccessoryControlKind, AccessoryControlPick,
272
272
  export { DEVICE_TYPE_CONTROL_KIND, hasMotionTrigger, isNode, MOTION_TRIGGER_FEATURE, pickAccessoryControl, resolveDeviceControlKind, resolveMutate, SENSOR_FEATURES, SENSOR_MAP, } from './device/device-control-resolution.js';
273
273
  export * from './device/hero/index.js';
274
274
  export { isDoPickerDeviceType } from './device/device-do-actions.js';
275
- export type { CapVocabularyEntry, CapVocabularyMap, L10n as VocabL10n, ActionEffect, CommandEffect, IndexedVocabAction, VocabActionRefusal, VocabCall, LooseCapVocabularyEntry, LooseVocabEffect, LooseVocabOffer, LooseVocabOpenArg, ResolvedBooleanTrigger, ResolvedEnumTrigger, ResolvedEnumValue, ResolvedEventTrigger, ResolvedNumericTrigger, ResolvedValueTrigger, ActionGateAnswer, ActionGateAnswerOf, DynamicOfferAnswer, DynamicOfferAnswerOf, LooseVocabActionGate, ResolvedVocabAction, ResolvedVocabTrigger, VocabBindingsInput, VocabCapName, VocabLocale, CapVocabularyDecl, DeviceCapVocabularyDecl, EventVocabularyDecl, LooseMethodActionDecl, MethodActionArgs, MethodActionDecl, MethodActionEffect, MethodActionGate, MethodActionOpenArg, SystemCapVocabularyDecl, } from './device/cap-vocabulary/index.js';
276
- export { actionEffect, actionGateAnswerFrom, actionOfferedWith, actionsForDevice as vocabularyActionsForDevice, deviceOffersActions, offeredActionsWith, allVocabActions, auditedFields, CAP_VOCABULARY, CAP_VOCABULARY_BY_NAME, commandEffect, findVocabAction, isCommand, renderVocabPhrase, triggersForDevice as vocabularyTriggersForDevice, VOCAB_TEMPLATES, vocabActionIdFor, vocabCall, VocabActionError, assertDeviceOffers, NOT_A_DEVICE, } from './device/cap-vocabulary/index.js';
275
+ export type { CapVocabularyEntry, CapVocabularyMap, L10n as VocabL10n, ActionEffect, CommandEffect, CommandSlice, LooseVocabActionHold, LooseVocabSideEffect, VocabEffectCondition, VocabEffectValue, IndexedVocabAction, VocabActionRefusal, VocabCall, LooseCapVocabularyEntry, LooseVocabEffect, LooseVocabOffer, LooseVocabOpenArg, ResolvedBooleanTrigger, ResolvedEnumTrigger, ResolvedEnumValue, ResolvedEventTrigger, ResolvedNumericTrigger, ResolvedValueTrigger, ActionGateAnswer, ActionGateAnswerOf, DynamicOfferAnswer, DynamicOfferAnswerOf, LooseVocabActionGate, ResolvedVocabAction, ResolvedVocabTrigger, VocabBindingsInput, VocabCapName, VocabLocale, CapVocabularyDecl, DeviceCapVocabularyDecl, EventVocabularyDecl, LooseMethodActionDecl, MethodActionArgs, MethodActionDecl, MethodActionEffect, MethodActionGate, MethodActionOpenArg, SystemCapVocabularyDecl, } from './device/cap-vocabulary/index.js';
276
+ export { actionEffect, actionGateAnswerFrom, actionOfferedWith, actionsForDevice as vocabularyActionsForDevice, deviceOffersActions, offeredActionsWith, allVocabActions, auditedFields, CAP_VOCABULARY, CAP_VOCABULARY_BY_NAME, commandEffect, commandEffects, commandHoldMs, effectConditionHolds, resolveSideEffect, findVocabAction, isCommand, renderVocabPhrase, triggersForDevice as vocabularyTriggersForDevice, VOCAB_TEMPLATES, vocabActionIdFor, vocabCall, VocabActionError, assertDeviceOffers, NOT_A_DEVICE, } from './device/cap-vocabulary/index.js';
277
277
  export { DEVICE_IDENTIFIER_KEYS, DeviceIdentifierEntrySchema, DeviceIdentifierKeySchema, DeviceIdentifierOriginSchema, DeviceIdentifiersSchema, identifierStrength, isEmptyIdentifiers, mergeIdentifiers, normaliseIdentifiers, sameIdentifiers, normaliseMac, } from './device/device-identifiers.js';
278
278
  export type { AcceptedValue, DeviceIdentifierEntry, DeviceIdentifierKey, DeviceIdentifierOrigin, DeviceIdentifiers, DeviceIdentifierStrength, NormaliseIdentifiersOptions, NormalisedIdentifiers, NormaliseResult, RawDeviceIdentifiers, RawSerialIdentifier, RawVendorUidIdentifier, RejectedIdentifier, RejectedReason, } from './device/device-identifiers.js';
279
279
  export { declareDeviceIdentifiers } from './device/declare-identifiers.js';
@@ -491,3 +491,7 @@ export * from './migrations/api/migration-api.v1.js';
491
491
  export * from './migrations/api/migration-api.v1.schema.js';
492
492
  export * from './migrations/api/migration-api-ports.js';
493
493
  export { normalizeSearchText, searchRank, type SearchRankFields } from './search/search-match.js';
494
+ export { DEFAULT_COMMAND_HOLD_MS, MAX_COMMAND_HOLD_MS, resolveCommandHold, } from './device/command-hold.js';
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';
497
+ export type { CommandHoldOption, CommandHoldOptions, NativeCapOptions, ResolvedCommandHold, } from './device/command-hold.js';