@camstack/types 1.2.595 → 1.2.597

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,24 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
7
7
 
8
8
  ## [Unreleased]
9
9
 
10
+ ## [1.2.597] - 2026-11-18
11
+
12
+ ### Added
13
+
14
+ - Each integration instance now states what Add device offers inside it (scan, children or none), decided by its provider
15
+ - Pipeline steps can be switched per cluster (off, on, opt-in), per node and per accelerator; new pipelineOrchestrator methods setClusterStepMode, setNodeStepEnabled, setDeviceStepEnabled and getStepSwitches.
16
+
17
+ ### Changed
18
+
19
+ - InferenceDeviceExclusionReason gains 'root-switched-off' (D1065).
20
+ - A host or container card shows its running state instead of a dash.
21
+
22
+ ## [1.2.596] - 2026-11-18
23
+
24
+ ### Changed
25
+
26
+ - fetchDevice accepts a fresh option that bypasses the per-context binding cache
27
+
10
28
  ## [1.2.595] - 2026-11-18
11
29
 
12
30
  ### Changed
@@ -12,7 +12,7 @@
12
12
  * `{ $secretClear: true }` clears it; any other string replaces it.
13
13
  */
14
14
  import { z } from 'zod';
15
- import type { IntegrationInstanceDescription, IntegrationInstanceStatus, IIntegrationInstancesProvider } from '../capabilities/integration-instances.cap.js';
15
+ import type { IntegrationInstanceAddDevice, IntegrationInstanceDescription, IntegrationInstanceStatus, IIntegrationInstancesProvider } from '../capabilities/integration-instances.cap.js';
16
16
  import type { IntegrationTestConnectionResult } from '../capabilities/integrations.cap.js';
17
17
  import type { ConfigUISchema } from '../interfaces/config-ui.js';
18
18
  import type { DefinedRecordKind } from '../records/record-kind.js';
@@ -30,6 +30,12 @@ export declare function isInstanceEnabled(body: {
30
30
  }): boolean;
31
31
  /** The body key of the switch; only {@link RecordIntegrationInstances.setInstanceEnabled} writes it. */
32
32
  export declare const SWITCH_KEY = "enabled";
33
+ /**
34
+ * The "Add device" mode an instance gets when its provider states none, from how the provider's
35
+ * devices are found: `lan` scans, `account` adopts the account's children, anything else is manual.
36
+ * The one place this default lives.
37
+ */
38
+ export declare function defaultAddDeviceMode(description: Pick<IntegrationInstanceDescription, 'discovery'>): IntegrationInstanceAddDevice;
33
39
  /** What the instance went through when `onChanged` runs. */
34
40
  export type InstanceChange = 'created' | 'updated' | 'enabled' | 'deleted';
35
41
  export interface RecordIntegrationInstancesHooks<TBody extends InstanceBody> {
@@ -59,6 +65,11 @@ export interface RecordIntegrationInstancesHooks<TBody extends InstanceBody> {
59
65
  };
60
66
  /** The addon's own rule for "this instance can work". */
61
67
  configured(body: TBody): boolean;
68
+ /**
69
+ * What "Add device" inside this instance offers (`scan`, `children`, `none`). Absent: the default
70
+ * from `description.discovery` ({@link defaultAddDeviceMode}).
71
+ */
72
+ addDevice?(body: TBody): IntegrationInstanceAddDevice;
62
73
  /**
63
74
  * Runs after every create / update / enable / delete, IN the process that serves the instance:
64
75
  * the addon re-applies its runtime from the record (`readResolved(id)`), so an edit takes effect
package/dist/addon.js CHANGED
@@ -1,5 +1,5 @@
1
1
  Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
2
- const require_runtime_capabilities = require("./runtime-capabilities-wOKNm9iz.js");
2
+ const require_runtime_capabilities = require("./runtime-capabilities-DWgr8hrq.js");
3
3
  const require_event_category = require("./event-category-CMA0-jGW.js");
4
4
  const require_composed_stable_id = require("./composed-stable-id-DkF5-kuf.js");
5
5
  //#region src/generated/cap-input-defaults.ts
package/dist/addon.mjs CHANGED
@@ -1,4 +1,4 @@
1
- import { $ as CAP_STATE_LEAVES, $a as findMigrationsBlocked, $i as DeclarationRefusedError, $n as registerKnownSecret, A as DEVICE_SCOPED_CAPS, Ai as RECORD_DATABASES, Ba as isSecretFieldView, Bi as RECORD_SWEEP_INTERVAL_MS, Bn as OnBehalfSourceSchema, Ci as recordArrayItemPath, Ct as DEVICE_CHILDREN_BATCH_MAX, D as parseJsonUnknown, Da as emitReadiness, Di as RECORD_BATCH_MAX, Ea as createEvent, Ei as secretArrayPrefixes, Et as addonPagesSourceCapability, F as createEventBusSliceSource, Fi as RECORD_MAX_INDEXES, Gi as globalSecretScope, Gn as assertTransactScope, Gr as readErrorI18n, Ha as isSecretMarkerLike, Hi as arrayItemFieldPath, Hn as ruleFireOfClaim, Hr as ErrorI18nPayloadSchema, Ht as scopeKey, Ii as RECORD_MAX_INDEX_FIELDS, J as HF_REPO, Ji as parseSecretRef, Jn as createSecretsAccess, Ki as isSecretRef, Kn as resolveSecretViewsIn, La as SECRET_CLEAR, Li as RECORD_QUERY_MAX, Lt as MODEL_FORMATS, M as createDeviceProxy, Mi as RECORD_DELETE_BATCH, Ni as RECORD_ID_MAX_LENGTH, Nr as expandCapMethods, O as hfModelUrl, Oi as RECORD_BATCH_MAX_BYTES, P as addonSliceHandleApi, Pi as RECORD_MAX_DATA_BYTES, Qa as AddonMigrationsBlockedError, Qi as BatchTooLargeError, Qn as knownSecretCount, Ra as classifySecretWrite, Ri as RECORD_SECRET_COLLECTION_PREFIX, Rn as CommandOriginClaimSchema, Rt as ReadinessRegistry, S as asJsonObject, Si as parseSecretPath, Sr as defineRecordKinds, St as deviceOpsCapability, Ti as recordSecretRef, Tr as isZodSecret, Ua as makeSecretMarker, Ui as buildSecretRef, Un as makeInMemoryRecords, Va as isSecretMarker, Vi as SECRET_REF_SCHEME, Vn as RuleFireOriginSchema, W as isCommand, Wa as toSecretFieldView, Wi as formatSecretScope, Wn as createRecordsAccess, X as CAP_ADVANCE_FIELDS, Xn as clearKnownSecrets, Xr as normalizeAddonInitResult, Xt as createDebugEmitter, Yn as MIN_SCRUBBED_LENGTH, Z as CAP_METHOD_TIMEOUTS_MS, Zn as forgetKnownSecret, _r as RecordKindNameSchema, _t as switchRefusesSetState, aa as RECORDS_ERROR_CODES, ar as PEER_BYTES_TICKET_TTL_MS, at as defineCustomActions, bi as collectSecretLeaves, br as assertValidDeclaration, bt as MIGRATION_API_VERSION, ca as RecordTooLargeError, ci as resolveDeviceSettings, cr as DATAPLANE_SECRET_HEADER, da as RevConflictError, dr as defineEntryKind, dt as nodePin, ea as FilterRequiredError, er as scrubKnownSecrets, et as CAP_METHOD_NOT_IMPLEMENTED, fa as TransactRefusedError, fr as entryBody, ft as readCommandOrigin, ga as recordsErrorFromMessage, gr as RecordKindDeclarationSchema, gt as SWITCH_SETTABLE_GATE, ha as asRecordsError, hr as RecordIndexSchema, ht as viewerUiCapability, ia as PlaintextSecretError, ir as PEER_BYTES_STALL_MS, it as customAction, j as isDeviceScopedCap, ji as RECORD_DEFAULT_MAX_DATA_BYTES, k as BOOT_RECOVERY_BACKOFF_MS, ki as RECORD_CLASSES, la as RecordUniqueViolationError, li as resolvedValues, ma as UnknownRecordKindError, mr as RecordFieldPathSchema, n as describeNvidia, na as InvalidRecordError, nr as PEER_BYTES_CHUNK_BYTES, nt as CALLER_STAMPED_CAPABILITIES, oa as RecordNotFoundError, oi as SCOPED_SETTINGS_SCOPES, ot as describeCustomActions, pa as UnindexedFilterError, pr as EntryDescriptorSchema, pt as readNodePin, qi as normalizeSecretOwner, qn as REVALIDATE_AFTER_MS, qr as BaseAddon, ra as NoCallerError, rr as PEER_BYTES_MAX_OUTSTANDING, rt as withoutCallerStamp, sa as RecordSecretUnavailableError, si as nodeIdOfScopedKey, sr as CALLER_USERNAME_HEADER, ta as ForeignSecretMarkerError, tr as shortSecretRefHash, tt as isCapMethodAbsent, u as sleep, ua as RecordsError, ur as DisposerChain, ut as commandOrigin, vi as secretViewsOf, vr as RecordRetentionSchema, vt as PipelineRunResultBridge, w as asString, wi as recordSecretCollection, wr as collectZodSecretPaths, wt as adminUiCapability, xi as mapSecretLeaves, xr as declarationsOf, y as maskUrlCredentials, yi as REMOVE_LEAF, yr as StoredRecordKindDeclarationSchema, yt as PipelineStepInputSchema, za as isSecretClear, zi as RECORD_SETTINGS_MAX_ROWS, zn as OnBehalfSchema, zt as ReadinessTimeoutError } from "./runtime-capabilities-Bgt5QBvO.mjs";
1
+ import { $ as CAP_STATE_LEAVES, $a as AddonMigrationsBlockedError, $i as BatchTooLargeError, $n as registerKnownSecret, A as DEVICE_SCOPED_CAPS, Ai as RECORD_CLASSES, Ba as isSecretClear, Bi as RECORD_SETTINGS_MAX_ROWS, Bn as OnBehalfSourceSchema, Ci as parseSecretPath, Ct as DEVICE_CHILDREN_BATCH_MAX, D as parseJsonUnknown, Da as createEvent, Di as secretArrayPrefixes, Ei as recordSecretRef, Et as addonPagesSourceCapability, F as createEventBusSliceSource, Fi as RECORD_MAX_DATA_BYTES, Ga as toSecretFieldView, Gi as formatSecretScope, Gn as assertTransactScope, Gr as readErrorI18n, Ha as isSecretMarker, Hi as SECRET_REF_SCHEME, Hn as ruleFireOfClaim, Hr as ErrorI18nPayloadSchema, Ht as scopeKey, Ii as RECORD_MAX_INDEXES, J as HF_REPO, Ji as normalizeSecretOwner, Jn as createSecretsAccess, Ki as globalSecretScope, Kn as resolveSecretViewsIn, Li as RECORD_MAX_INDEX_FIELDS, Lt as MODEL_FORMATS, M as createDeviceProxy, Mi as RECORD_DEFAULT_MAX_DATA_BYTES, Ni as RECORD_DELETE_BATCH, Nr as expandCapMethods, O as hfModelUrl, Oa as emitReadiness, Oi as RECORD_BATCH_MAX, P as addonSliceHandleApi, Pi as RECORD_ID_MAX_LENGTH, Qn as knownSecretCount, Ra as SECRET_CLEAR, Ri as RECORD_QUERY_MAX, Rn as CommandOriginClaimSchema, Rt as ReadinessRegistry, S as asJsonObject, Si as mapSecretLeaves, Sr as defineRecordKinds, St as deviceOpsCapability, Ti as recordSecretCollection, Tr as isZodSecret, Ua as isSecretMarkerLike, Ui as arrayItemFieldPath, Un as makeInMemoryRecords, Va as isSecretFieldView, Vi as RECORD_SWEEP_INTERVAL_MS, Vn as RuleFireOriginSchema, W as isCommand, Wa as makeSecretMarker, Wi as buildSecretRef, Wn as createRecordsAccess, X as CAP_ADVANCE_FIELDS, Xn as clearKnownSecrets, Xr as normalizeAddonInitResult, Xt as createDebugEmitter, Yi as parseSecretRef, Yn as MIN_SCRUBBED_LENGTH, Z as CAP_METHOD_TIMEOUTS_MS, Zn as forgetKnownSecret, _a as recordsErrorFromMessage, _r as RecordKindNameSchema, _t as switchRefusesSetState, aa as PlaintextSecretError, ar as PEER_BYTES_TICKET_TTL_MS, at as defineCustomActions, bi as REMOVE_LEAF, br as assertValidDeclaration, bt as MIGRATION_API_VERSION, ca as RecordSecretUnavailableError, ci as resolveDeviceSettings, cr as DATAPLANE_SECRET_HEADER, da as RecordsError, dr as defineEntryKind, dt as nodePin, ea as DeclarationRefusedError, eo as findMigrationsBlocked, er as scrubKnownSecrets, et as CAP_METHOD_NOT_IMPLEMENTED, fa as RevConflictError, fr as entryBody, ft as readCommandOrigin, ga as asRecordsError, gr as RecordKindDeclarationSchema, gt as SWITCH_SETTABLE_GATE, ha as UnknownRecordKindError, hr as RecordIndexSchema, ht as viewerUiCapability, ia as NoCallerError, ir as PEER_BYTES_STALL_MS, it as customAction, j as isDeviceScopedCap, ji as RECORD_DATABASES, k as BOOT_RECOVERY_BACKOFF_MS, ki as RECORD_BATCH_MAX_BYTES, la as RecordTooLargeError, li as resolvedValues, ma as UnindexedFilterError, mr as RecordFieldPathSchema, n as describeNvidia, na as ForeignSecretMarkerError, nr as PEER_BYTES_CHUNK_BYTES, nt as CALLER_STAMPED_CAPABILITIES, oa as RECORDS_ERROR_CODES, oi as SCOPED_SETTINGS_SCOPES, ot as describeCustomActions, pa as TransactRefusedError, pr as EntryDescriptorSchema, pt as readNodePin, qi as isSecretRef, qn as REVALIDATE_AFTER_MS, qr as BaseAddon, ra as InvalidRecordError, rr as PEER_BYTES_MAX_OUTSTANDING, rt as withoutCallerStamp, sa as RecordNotFoundError, si as nodeIdOfScopedKey, sr as CALLER_USERNAME_HEADER, ta as FilterRequiredError, tr as shortSecretRefHash, tt as isCapMethodAbsent, u as sleep, ua as RecordUniqueViolationError, ur as DisposerChain, ut as commandOrigin, vr as RecordRetentionSchema, vt as PipelineRunResultBridge, w as asString, wi as recordArrayItemPath, wr as collectZodSecretPaths, wt as adminUiCapability, xi as collectSecretLeaves, xr as declarationsOf, y as maskUrlCredentials, yi as secretViewsOf, yr as StoredRecordKindDeclarationSchema, yt as PipelineStepInputSchema, za as classifySecretWrite, zi as RECORD_SECRET_COLLECTION_PREFIX, zn as OnBehalfSchema, zt as ReadinessTimeoutError } from "./runtime-capabilities-qX7BpOYT.mjs";
2
2
  import { t as EventCategory } from "./event-category-7P4A3bYA.mjs";
3
3
  import { a as DeviceType, s as errMsg, t as COMPOSED_DEVICE_STABLE_ID_PREFIX } from "./composed-stable-id-DIeNz933.mjs";
4
4
  //#region src/generated/cap-input-defaults.ts
@@ -114,12 +114,12 @@ export { NetworkAccessStatusSchema, NetworkEndpointSchema, NetworkTunnelStartedD
114
114
  export { type Attachment, type AttachmentMediaType, AttachmentMediaTypeSchema, AttachmentSchema, type DeliveryParam, DeliveryParamSchema, type DeliveryParamValue, DeliveryParamValueSchema, type DiscoveredTarget, DiscoveredTargetSchema, type INotificationOutputProvider, type NotificationAction, type NotificationActionIcon, NotificationActionIconSchema, NotificationActionSchema, type NotificationField, NotificationFieldSchema, type NotificationFormat, NotificationFormatSchema, NotificationSchema, notificationOutputCapability, type ProbeTargetConfigResult, ProbeTargetConfigResultSchema, type RenderedAs, RenderedAsSchema, type SendResult, SendResultSchema, type Target, type TargetKind, type TargetKindCaps, TargetKindCapsSchema, type TargetKindLevel, TargetKindLevelSchema, TargetKindSchema, type TargetKindTextCaps, TargetKindTextCapsSchema, TargetSchema, type TestResult, TestResultSchema, } from './notification-output.cap.js';
115
115
  export { consumableLowPercentOf, type INotificationRulesProvider, isRetiredClearKey, NC_ALARM_DELAY_MAX_SEC, NC_ALARM_NONBLOCKING_MAX, NC_ALARM_SENSORS_MAX, NC_ALARM_SYSTEM_EVENT_KINDS, NC_ALARM_TRIGGERED_MAX_SEC, NC_AUDIO_DBFS_FLOOR, NC_AUTHORABLE_SYSTEM_EVENT_KINDS, NC_LEGACY_SYSTEM_EVENT_KINDS, NC_BATTERY_CONSUMABLE_SYSTEM_EVENT_KINDS, NC_CLIP_POST_ROLL_DEFAULT_SEC, NC_CLIP_PRE_ROLL_DEFAULT_SEC, NC_CLIP_RETENTION_MAX_SEC, NC_CONDITION_CATALOG, NC_CONFIRM_DEFAULT_MAX_IMAGE_PX, NC_CONFIRM_DEFAULT_TIMEOUT_MS, NC_CONFIRM_MAX_TIMEOUT_MS, NC_CONFIRM_MIN_TIMEOUT_MS, NC_CONSUMABLE_LOW_PERCENT_DEFAULT, NC_CONSUMABLE_LOW_PERCENT_MAX, NC_CONSUMABLE_SYSTEM_EVENT_KINDS, NC_DEFAULT_SNOOZE_MINUTES, NC_GROUPING_DEFAULT_SEC, NC_GROUPING_MAX_SEC, NC_GROUPING_MIN_SEC, NC_GROUP_WITHIN_MAX_SEC, NC_GROUP_WITHIN_OTHER_DEFAULT_SEC, NC_GROUP_WITHIN_SYSTEM_DEFAULT_SEC, NC_HISTORY_LIMIT_DEFAULT, NC_HISTORY_LIMIT_MAX, NC_MAX_PER_TRACK_IMMEDIATE, NC_RULE_CLEARABLE_KEYS, NC_RULE_RETIRED_CLEAR_KEYS, NC_SNOOZE_MAX_MINUTES, type NcAlarmBlocking, type NcAlarmBlockingEdit, NcAlarmBlockingEditSchema, NcAlarmBlockingSchema, type NcAlarmConfig, NcAlarmConfigSchema, type NcAlarmCreateProfileInput, NcAlarmCreateProfileInputSchema, type NcAlarmModeCoverage, NcAlarmModeCoverageSchema, type NcAlarmModeDelays, type NcAlarmModeDelaysEdit, NcAlarmModeDelaysEditSchema, NcAlarmModeDelaysSchema, type NcAlarmModeDeviceList, NcAlarmModeDeviceListSchema, type NcAlarmNonBlocking, type NcAlarmNonBlockingEdit, NcAlarmNonBlockingEditSchema, NcAlarmNonBlockingSchema, type NcAlarmPostTriggeredAction, NcAlarmPostTriggeredActionSchema, type NcAlarmProfileIdInput, NcAlarmProfileIdInputSchema, type NcAlarmProfileMeta, NcAlarmProfileMetaSchema, type NcAlarmProfilesView, NcAlarmProfilesViewSchema, type NcAlarmRenameProfileInput, NcAlarmRenameProfileInputSchema, type NcAlarmSecureOnArmEdit, NcAlarmSecureOnArmEditSchema, type NcAlarmSecureOnArmOff, NcAlarmSecureOnArmOffSchema, type NcAlarmSensorReading, NcAlarmSensorReadingSchema, type NcAlarmSensorState, NcAlarmSensorStateSchema, type NcAlarmSensors, type NcAlarmSensorsInput, NcAlarmSensorsInputSchema, NcAlarmSensorsSchema, type NcAlarmSettings, type NcAlarmSettingsPatch, NcAlarmSettingsPatchSchema, NcAlarmSettingsSchema, type NcAlarmSkippedDevice, NcAlarmSkippedDeviceSchema, type NcAlarmSkipReason, NcAlarmSkipReasonSchema, type NcAudioCondition, NcAudioConditionSchema, type NcClipRetentionAsk, NcClipRetentionAskSchema, type NcClipRetentionPlan, NcClipRetentionPlanSchema, type NcConditionDescriptor, NcConditionDescriptorSchema, type NcConditions, NcConditionsSchema, type NcConfirm, type NcConfirmExpect, NcConfirmExpectSchema, NcConfirmSchema, type NcCrossing, NcCrossingSchema, type NcDelivery, NcDeliverySchema, type NcDeviceStateCondition, NcDeviceStateConditionSchema, type NcHistoryEntry, NcHistoryEntrySchema, type NcHistoryFilter, NcHistoryFilterSchema, type NcHistoryRecordKind, NcHistoryRecordKindSchema, type NcHistoryStatus, NcHistoryStatusSchema, type NcHistorySubject, NcHistorySubjectSchema, type NcLinkedCameraMode, NcLinkedCameraModeSchema, type NcMediaFrame, NcMediaFrameSchema, type NcMediaImage, NcMediaImageSchema, type NcMediaPolicy, NcMediaPolicySchema, type NcOccupancyCondition, NcOccupancyConditionSchema, type NcPlateMatcher, NcPlateMatcherSchema, type NcRule, type NcRuleActions, NcRuleActionsSchema, NcActionIdSchema, type NcHookActionIds, NcHookActionIdsSchema, type NcRuleClearableKey, NcRuleClearableKeySchema, type NcRuleInput, NcRuleInputSchema, type NcRuleTagsEntry, NcRuleTagsEntrySchema, type NcTaggedRuleKind, NcTaggedRuleKindSchema, NcRuleKindSchema, type NcRuleLastRun, NcRuleLastRunSchema, type NcRuleLastRuns, NcRuleLastRunsSchema, type NcRuleNotificationButton, NcRuleNotificationButtonSchema, type NcRulePatch, NcRulePatchSchema, NcRuleSchema, type NcRuleTarget, NcRuleTargetSchema, type NcTargetAttachment, NcTargetAttachmentSchema, type NcTargetOverride, NcTargetOverrideSchema, NC_TEMPLATE_TITLE_MAX_CHARS, type NcTargetOverrides, NcTargetOverridesSchema, type NcRuleUpdateInput, NcRuleUpdateInputSchema, type NcSceneCondition, NcSceneConditionSchema, type NcSchedule, NcScheduleSchema, type NcScheduleWindow, NcScheduleWindowSchema, type NcSensorTransition, NcSensorTransitionSchema, type NcSnooze, type NcSnoozeInput, NcSnoozeInputSchema, NcSnoozeSchema, type NcSnoozeScope, NcSnoozeScopeSchema, type NcSnoozeSuppressed, NcSnoozeSuppressedSchema, type NcStateSummaryPreview, type NcStateSummaryPreviewRow, NcStateSummaryPreviewRowSchema, NcStateSummaryPreviewSchema, type NcStateSummaryPreviewSection, NcStateSummaryPreviewSectionSchema, type NcStateSummarySectionId, NC_STATE_SUMMARY_SECTION_IDS, NcStateSummarySectionIdSchema, type NcStateSummarySplit, NcStateSummarySplitSchema, type NcSystemEventCondition, NcSystemEventConditionSchema, type NcSystemEventDelivery, type NcSystemEventDeliveryMode, NcSystemEventDeliveryModeSchema, type NcSystemEventDeliveryToggle, NcSystemEventDeliveryToggleSchema, type NcSystemEventModesDelivery, NcSystemEventDeliverySchema, type NcSystemEventKind, NcSystemEventKindSchema, NC_COMMAND_ACTOR_KINDS, NC_COMMAND_OUTCOMES, type NcTemplateDefault, NcTemplateDefaultSchema, type NcTemplateFamily, NcTemplateFamilySchema, type NcTemplateField, NcTemplateFieldSchema, type NcTemplatePreview, type NcTemplatePreviewInput, NcTemplatePreviewInputSchema, NcTemplatePreviewSchema, type NcTemplateVarContext, NcTemplateVarContextSchema, type NcTemplateVarDescriptor, NcTemplateVarDescriptorSchema, type NcTemplateVarGroup, NcTemplateVarGroupSchema, type NcTemplateVarKind, NcTemplateVarKindSchema, type NcTestResult, NcTestResultSchema, type NcThrottle, type NcThrottleGranularity, NcThrottleGranularitySchema, NcThrottleSchema, type NcZoneCondition, NcZoneConditionSchema, notificationRulesCapability, } from './notification-rules.cap.js';
116
116
  export { type IOauthIntegrationProvider, type OauthIntegrationDescriptor, OauthIntegrationDescriptorSchema, oauthIntegrationCapability, } from './oauth-integration.cap.js';
117
- export { type IIntegrationInstancesProvider, type IntegrationInstance, type IntegrationInstanceDescription, IntegrationInstanceDescriptionSchema, type IntegrationInstanceDiscovery, IntegrationInstanceDiscoverySchema, IntegrationInstanceIdSchema, type IntegrationInstanceKind, type IntegrationInstanceLink, IntegrationInstanceLinkSchema, IntegrationInstanceKindSchema, type IntegrationInstanceMode, IntegrationInstanceModeSchema, type IntegrationInstancePatch, IntegrationInstancePatchSchema, type IntegrationInstanceRole, IntegrationInstanceRoleSchema, IntegrationInstanceSchema, type IntegrationInstanceStatus, IntegrationInstanceStatusSchema, integrationInstancesCapability, } from './integration-instances.cap.js';
117
+ export { type IIntegrationInstancesProvider, type IntegrationInstance, type IntegrationInstanceAddDevice, IntegrationInstanceAddDeviceSchema, type IntegrationInstanceDescription, IntegrationInstanceDescriptionSchema, type IntegrationInstanceDiscovery, IntegrationInstanceDiscoverySchema, IntegrationInstanceIdSchema, type IntegrationInstanceKind, type IntegrationInstanceLink, IntegrationInstanceLinkSchema, IntegrationInstanceKindSchema, type IntegrationInstanceMode, IntegrationInstanceModeSchema, type IntegrationInstancePatch, IntegrationInstancePatchSchema, type IntegrationInstanceRole, IntegrationInstanceRoleSchema, IntegrationInstanceSchema, type IntegrationInstanceStatus, IntegrationInstanceStatusSchema, integrationInstancesCapability, } from './integration-instances.cap.js';
118
118
  export { AnalyticsLtsSeriesSchema, type AudioEvent, type AudioEventDraft, AudioEventSchema, type DetectionSource, DetectionSourceSchema, EVENT_DENSITY_BATCH_MAX, type EventDensityBucket, EventDensityBucketSchema, type EventDensityForDevice, EventDensityForDeviceSchema, type EventKind, type EventKindCategory, EventKindCategorySchema, type EventKindDescriptor, EventKindDescriptorSchema, type EventKindIcon, EventKindIconSchema, EventKindSchema, type EventKindsForDevice, EventKindsForDeviceSchema, type EventMediaKindBreakdown, type EventMediaKindFootprint, type EventPruneCounts, type EventStoreDeviceFootprint, type EventStoreFootprint, type IPipelineAnalyticsProvider, type KeyEvent, KeyEventSchema, type KeyEventsForDevice, type LabelAttribution, LabelAttributionSchema, type LabelTier, LabelTierSchema, LTS_SCOPE_CLASS_SEPARATOR, type LtsBucket, LtsBucketSchema, MAX_TRACK_DEBUG_NOTE_LEN, type MediaFile, type MediaFileBytes, type MediaFileInfo, MediaFileInfoSchema, type MediaFileKind, MediaFileKindEnum, type MediaFileRef, MediaFileRefSchema, MediaFileSchema, type MotionEvent, type MotionEventDraft, MotionEventSchema, type ObjectEvent, type ObjectEventDraft, ObjectEventSchema, occupancyScope, parseOccupancyScope, pipelineAnalyticsCapability, type RebuildObjectEmbeddingsRefusal, RebuildObjectEmbeddingsRefusalSchema, type RecentTracksPage, RecentTracksPageSchema, type RecentTracksQuery, RecentTracksQueryInput, type RetrainBoxReview, RetrainBoxReviewSchema, type RetrainDismissed, RetrainDismissedSchema, type RetrainFrameReview, RetrainFrameReviewSchema, type RetrainOrigin, RetrainOriginSchema, type RetrainReviewStatus, RetrainReviewStatusSchema, type RetrainAnnotation, type RetrainAnnotationDraft, RetrainAnnotationDraftSchema, RetrainAnnotationKindSchema, RetrainAnnotationSchema, type RetrainAnnotationSource, RetrainAnnotationSourceSchema, type RetrainArchiveResult, RetrainArchiveResultSchema, type RetrainArchiveTarget, RetrainArchiveTargetSchema, type RetrainAssistResult, RetrainAssistResultSchema, RetrainAssistSubjectSchema, RetrainCopyRefusalSchema, type RetrainExportFilter, RetrainExportFilterSchema, type RetrainExportLayout, RetrainExportLayoutSchema, type AddRetrainFrameFromRecordingResult, AddRetrainFrameFromRecordingResultSchema, type RetrainDatasetSelection, RetrainDatasetSelectionSchema, type RetrainDatasetStats, RetrainDatasetStatsSchema, type RetrainDatasetVersion, RetrainDatasetVersionSchema, type RetrainTrainingCorpusResolveResult, RetrainTrainingCorpusResolveResultSchema, type RetrainTrainingCorpusSelection, RetrainTrainingCorpusSelectionSchema, type RetrainAssistProfile, RetrainAssistProfileSchema, type RetrainLlmAssistResult, RetrainLlmAssistResultSchema, type RetrainLlmProposal, RetrainLlmProposalSchema, type RetrainLlmReview, RetrainLlmReviewSchema, type RetrainCollection, type RetrainCollectionCreateResult, RetrainCollectionCreateResultSchema, type RetrainCollectionRenameResult, RetrainCollectionRenameResultSchema, RetrainCollectionSchema, type RetrainCorpusFilter, RetrainCorpusFilterSchema, type RetrainCorpusKpi, RetrainCorpusKpiSchema, type RetrainCorpusKpiCameraRow, RetrainCorpusKpiCameraRowSchema, type RetrainCorpusPage, RetrainCorpusPageSchema, type RetrainCorpusPageFrame, RetrainCorpusPageFrameSchema, type RetrainFrame, type RetrainFrameCandidate, RetrainFrameCandidateSchema, type RetrainFrameList, RetrainFrameListSchema, type RetrainFrameOrigin, RetrainFrameOriginSchema, RetrainFrameSchema, type RetrainFrameSelection, RetrainFrameSelectionSchema, type RetrainFrameWorkState, RetrainFrameWorkStateSchema, type RetrainMacroClass, RetrainMacroClassSchema, type RetrainPipelineBox, RetrainPipelineBoxSchema, type RetrainStatus, RetrainStatusSchema, type RetrainTrack, RetrainTrackSchema, type RetrainTransitionResult, RetrainTransitionResultSchema, type RetrainVerdict, RetrainVerdictSchema, type RetrainVerdictSubject, RetrainVerdictSubjectSchema, type RetrainVerdictValue, RetrainVerdictValueSchema, type ScoredObjectEvent, ScoredObjectEventSchema, type SensorEvent, SensorEventSchema, type Track, type TrackCascadeCounts, TrackCascadeCountsSchema, type TrackEnvelope, TrackEnvelopeSchema, TrackedDetectionSchema, type TrackFlags, type TrackFlagsPatch, TrackFlagsPatchSchema, TrackFlagsSchema, type TrackPlacement, TrackPlacementSchema, type TrackProjection, TrackProjectionSchema, TrackSchema, type TrackSource, TrackSourceSchema, type TrackState, TrackStateSchema, type TrackZoneFilter, TrackZoneFilterSchema, type TrainingExportDeviceTotals, TrainingExportDeviceTotalsSchema, type TrainingExportSummary, TrainingExportSummarySchema, type ZoneCrossing, type ZoneCrossingDirection, ZoneCrossingDirectionSchema, ZoneCrossingSchema, } from './pipeline-analytics.cap.js';
119
119
  export type { EffectiveTuning, EffectiveTuningInput, NativeCropRef, PipelineStepInputOutput, PipelineValidationIssue, PipelineValidationResult, SuppliedRootOutput, } from './pipeline-executor.cap.js';
120
120
  export { EffectiveTuningSchema, ModelSubstitutionSchema, NativeCropRefSchema, PipelineDefaultStepSchema, PipelineEngineChoiceSchema, PipelineRunResultBridge, PipelineStepInputSchema, PipelineValidationIssueSchema, PipelineValidationResultSchema, pipelineExecutorCapability, NormalizedRectSchema, SuppliedRootOutputSchema, } from './pipeline-executor.cap.js';
121
- export type { CameraAssignmentStatus, CameraAudioStatus, CameraBrokerProfile, CameraBrokerStatus, CameraDecoderStatus, CameraDetectionPhase, CameraDetectionProvisioning, CameraDetectionProvisioningState, CameraDetectionStatus, CameraMotionStatus, CameraRecordingMode, CameraRecordingStatus, CameraSourceStatus, CameraDetectionSource, CameraSourceStream, CameraStatus, CameraStatusDegradation, CameraStatusDegradationReason, CameraStatusStage, ClusterModelChoice, ClusterModelChoiceUnreadableReason, DiskReconcileJob, InferenceDeviceExclusionReason, IngestOwner, NodeInferenceDevice, NodeInferenceDevices, OccupancyLookAnswer, OccupancyLookRefusal, OccupancyLookRequest, SetCameraSensorsInput, } from './pipeline-orchestrator.cap.js';
122
- export { AgentLoadSummarySchema, CameraAssignmentStatusSchema, CameraAudioStatusSchema, CameraBrokerProfileSchema, CameraBrokerStatusSchema, CameraDecoderStatusSchema, CameraDetectionSourceSchema, CameraDetectionPhaseSchema, CameraDetectionProvisioningSchema, CameraDetectionProvisioningStateSchema, CameraDetectionStatusSchema, CameraMotionStatusSchema, CameraRecordingModeSchema, CameraRecordingStatusSchema, CameraSourceStatusSchema, CameraSourceStreamSchema, CameraStatusDegradationReasonSchema, CameraStatusDegradationSchema, CameraStatusSchema, CameraStatusStageSchema, CapabilityBindingsSchema, CLUSTER_MODEL_CHOICE_UNREADABLE_REASONS, ClusterModelChoiceSchema, DiskReconcileJobSchema, GlobalMetricsSchema, INFERENCE_DEVICE_EXCLUSION_REASONS, InferenceDeviceExclusionReasonSchema, IngestOwnerSchema, OccupancyLookAnswerSchema, OccupancyLookRefusalSchema, OccupancyLookRequestSchema, PipelineAssignmentSchema, pipelineOrchestratorCapability, SetCameraSensorsInputSchema, } from './pipeline-orchestrator.cap.js';
121
+ export type { CameraAssignmentStatus, CameraAudioStatus, CameraBrokerProfile, CameraBrokerStatus, CameraDecoderStatus, CameraDetectionPhase, CameraDetectionProvisioning, CameraDetectionProvisioningState, CameraDetectionStatus, CameraMotionStatus, CameraRecordingMode, CameraRecordingStatus, CameraSourceStatus, CameraDetectionSource, CameraSourceStream, CameraStatus, CameraStatusDegradation, CameraStatusDegradationReason, CameraStatusStage, ClusterModelChoice, ClusterModelChoiceUnreadableReason, DiskReconcileJob, InferenceDeviceExclusionReason, IngestOwner, NodeInferenceDevice, NodeInferenceDevices, OccupancyLookAnswer, OccupancyLookRefusal, OccupancyLookRequest, SetCameraSensorsInput, StepClusterMode, StepSwitchCell, StepSwitchMatrix, } from './pipeline-orchestrator.cap.js';
122
+ export { AgentLoadSummarySchema, CameraAssignmentStatusSchema, CameraAudioStatusSchema, CameraBrokerProfileSchema, CameraBrokerStatusSchema, CameraDecoderStatusSchema, CameraDetectionSourceSchema, CameraDetectionPhaseSchema, CameraDetectionProvisioningSchema, CameraDetectionProvisioningStateSchema, CameraDetectionStatusSchema, CameraMotionStatusSchema, CameraRecordingModeSchema, CameraRecordingStatusSchema, CameraSourceStatusSchema, CameraSourceStreamSchema, CameraStatusDegradationReasonSchema, CameraStatusDegradationSchema, CameraStatusSchema, CameraStatusStageSchema, CapabilityBindingsSchema, CLUSTER_MODEL_CHOICE_UNREADABLE_REASONS, ClusterModelChoiceSchema, DiskReconcileJobSchema, GlobalMetricsSchema, INFERENCE_DEVICE_EXCLUSION_REASONS, InferenceDeviceExclusionReasonSchema, IngestOwnerSchema, OccupancyLookAnswerSchema, OccupancyLookRefusalSchema, OccupancyLookRequestSchema, PipelineAssignmentSchema, pipelineOrchestratorCapability, SetCameraSensorsInputSchema, StepClusterModeSchema, StepSwitchCellSchema, StepSwitchMatrixSchema, } from './pipeline-orchestrator.cap.js';
123
123
  export type { DetailParent, DetailResult, MotionSource, MotionSources, OccupancyBurstRefusal, ParkedFrameKind, ParkedTrackFrame, ParkRefusal, ParkTrackFrameResult, ReportMotionInput, RunDetailSubtreeInput, RunDetailSubtreeResult, RunnerFrameSource, RunnerInferenceDevice, RunnerJumpStepProvisioning, RunStatelessStepInput, RunStatelessStepResult, StatelessStepRefusal, } from './pipeline-runner.cap.js';
124
124
  export { type DetectionSources, DetectionSourcesSchema, FrameLazyCountersSchema, FrameLazyMetricsSchema, MOTION_SOURCE_LABELS, MotionSourceEnum, MotionSourcesSchema, motionSourceLabel, type NativeCropBbox, type NativeCropCapResult, NativeCropBboxSchema, NativeCropResultSchema, OccupancyBurstRefusalSchema, ParkedFrameKindSchema, ParkedTrackFrameSchema, ParkRefusalSchema, ParkTrackFrameResultSchema, pipelineRunnerCapability, ReportMotionInputSchema, RunnerCameraConfigSchema, RunnerCameraDeviceUIFields, RunnerFrameSourceSchema, RunnerInferenceDeviceSchema, RunnerJumpStepProvisioningSchema, RunnerLocalLoadSchema, RunnerLocalMetricsSchema, type SessionTrigger, SessionTriggerSchema, } from './pipeline-runner.cap.js';
125
125
  export type { AudioClassifyOutcome, AudioNotClassifiedReason, } from './schemas/detection-shared.js';
@@ -158,6 +158,17 @@ export declare const IntegrationInstanceStatusSchema: z.ZodObject<{
158
158
  detail: z.ZodOptional<z.ZodString>;
159
159
  label: z.ZodOptional<z.ZodString>;
160
160
  }, z.core.$strip>;
161
+ /**
162
+ * What "Add device" inside ONE instance offers, decided per instance by its provider. `scan`: the
163
+ * LAN scan finds devices this instance holds; `children`: only the instance's own children, via
164
+ * adoption (a scan would offer other hosts, which are new integrations); `none`: manual add only.
165
+ */
166
+ export declare const IntegrationInstanceAddDeviceSchema: z.ZodEnum<{
167
+ children: "children";
168
+ none: "none";
169
+ scan: "scan";
170
+ }>;
171
+ export type IntegrationInstanceAddDevice = z.infer<typeof IntegrationInstanceAddDeviceSchema>;
161
172
  export declare const IntegrationInstanceSchema: z.ZodObject<{
162
173
  id: z.ZodString;
163
174
  name: z.ZodString;
@@ -176,6 +187,11 @@ export declare const IntegrationInstanceSchema: z.ZodObject<{
176
187
  label: z.ZodOptional<z.ZodString>;
177
188
  }, z.core.$strip>>;
178
189
  lastCheckedAt: z.ZodOptional<z.ZodNumber>;
190
+ addDevice: z.ZodOptional<z.ZodEnum<{
191
+ children: "children";
192
+ none: "none";
193
+ scan: "scan";
194
+ }>>;
179
195
  }, z.core.$strip>;
180
196
  export type IntegrationInstance = z.infer<typeof IntegrationInstanceSchema>;
181
197
  export declare const IntegrationInstancePatchSchema: z.ZodObject<{
@@ -279,6 +295,11 @@ export declare const integrationInstancesCapability: {
279
295
  label: z.ZodOptional<z.ZodString>;
280
296
  }, z.core.$strip>>;
281
297
  lastCheckedAt: z.ZodOptional<z.ZodNumber>;
298
+ addDevice: z.ZodOptional<z.ZodEnum<{
299
+ children: "children";
300
+ none: "none";
301
+ scan: "scan";
302
+ }>>;
282
303
  }, z.core.$strip>>>, import("./capability-definition.js").CapabilityMethodKind> & {
283
304
  readonly caller: 'scoped';
284
305
  };
@@ -302,6 +323,11 @@ export declare const integrationInstancesCapability: {
302
323
  label: z.ZodOptional<z.ZodString>;
303
324
  }, z.core.$strip>>;
304
325
  lastCheckedAt: z.ZodOptional<z.ZodNumber>;
326
+ addDevice: z.ZodOptional<z.ZodEnum<{
327
+ children: "children";
328
+ none: "none";
329
+ scan: "scan";
330
+ }>>;
305
331
  }, z.core.$strip>>, import("./capability-definition.js").CapabilityMethodKind> & {
306
332
  readonly caller: 'scoped';
307
333
  };
@@ -584,11 +584,14 @@ declare const INFERENCE_DEVICE_EXCLUSION_REASONS: readonly [
584
584
  /** Its engine format cannot run the object-detection camera root. */
585
585
  'cannot-host-camera-root',
586
586
  /** It is the CPU fallback and this node has a real accelerator serving (D215). */
587
- 'accelerator-preferred'];
587
+ 'accelerator-preferred',
588
+ /** The camera root step is switched off on it: cluster, node or device (D1065). */
589
+ 'root-switched-off'];
588
590
  declare const InferenceDeviceExclusionReasonSchema: z.ZodEnum<{
589
591
  "accelerator-preferred": "accelerator-preferred";
590
592
  "cannot-host-camera-root": "cannot-host-camera-root";
591
593
  disabled: "disabled";
594
+ "root-switched-off": "root-switched-off";
592
595
  unavailable: "unavailable";
593
596
  }>;
594
597
  declare const NodeInferenceDeviceSchema: z.ZodObject<{
@@ -617,11 +620,13 @@ declare const NodeInferenceDeviceSchema: z.ZodObject<{
617
620
  modelId: z.ZodOptional<z.ZodString>;
618
621
  settings: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
619
622
  jumpDeviceKey: z.ZodOptional<z.ZodString>;
623
+ enabled: z.ZodOptional<z.ZodBoolean>;
620
624
  }, z.core.$strip>>>;
621
625
  exclusion: z.ZodNullable<z.ZodEnum<{
622
626
  "accelerator-preferred": "accelerator-preferred";
623
627
  "cannot-host-camera-root": "cannot-host-camera-root";
624
628
  disabled: "disabled";
629
+ "root-switched-off": "root-switched-off";
625
630
  unavailable: "unavailable";
626
631
  }>>;
627
632
  }, z.core.$strip>;
@@ -679,15 +684,125 @@ declare const NodeInferenceDevicesSchema: z.ZodObject<{
679
684
  modelId: z.ZodOptional<z.ZodString>;
680
685
  settings: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
681
686
  jumpDeviceKey: z.ZodOptional<z.ZodString>;
687
+ enabled: z.ZodOptional<z.ZodBoolean>;
682
688
  }, z.core.$strip>>>;
683
689
  exclusion: z.ZodNullable<z.ZodEnum<{
684
690
  "accelerator-preferred": "accelerator-preferred";
685
691
  "cannot-host-camera-root": "cannot-host-camera-root";
686
692
  disabled: "disabled";
693
+ "root-switched-off": "root-switched-off";
687
694
  unavailable: "unavailable";
688
695
  }>>;
689
696
  }, z.core.$strip>>>;
690
697
  }, z.core.$strip>;
698
+ /**
699
+ * The CLUSTER switch of one pipeline step (D1065):
700
+ * - `off` — hard off: no camera, node or device can turn it on;
701
+ * - `on` — on by default; a camera may turn it off (`stepToggles`);
702
+ * - `opt-in` — off by default; a camera turns it on (`stepToggles`).
703
+ * Absent = the catalog's `enabledByDefault` (`true` → `on`, `false` → `opt-in`).
704
+ */
705
+ export declare const StepClusterModeSchema: z.ZodEnum<{
706
+ off: "off";
707
+ on: "on";
708
+ "opt-in": "opt-in";
709
+ }>;
710
+ export type StepClusterMode = z.infer<typeof StepClusterModeSchema>;
711
+ /**
712
+ * What one step does on one (node, device) — computed by the orchestrator with
713
+ * the SAME placement function the attach path runs (`pipeline-resolver.ts`),
714
+ * so a client never re-derives it. Precedence: cluster off > camera toggle
715
+ * (else the cluster default) > node off > device off / jump.
716
+ */
717
+ export declare const StepSwitchCellSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
718
+ kind: z.ZodLiteral<"on">;
719
+ }, z.core.$strip>, z.ZodObject<{
720
+ kind: z.ZodLiteral<"off-cluster">;
721
+ }, z.core.$strip>, z.ZodObject<{
722
+ kind: z.ZodLiteral<"off-node">;
723
+ }, z.core.$strip>, z.ZodObject<{
724
+ kind: z.ZodLiteral<"off-device">;
725
+ }, z.core.$strip>, z.ZodObject<{
726
+ kind: z.ZodLiteral<"jump">;
727
+ toDeviceKey: z.ZodString;
728
+ }, z.core.$strip>, z.ZodObject<{
729
+ kind: z.ZodLiteral<"skip">;
730
+ reason: z.ZodEnum<{
731
+ "no-compatible-model": "no-compatible-model";
732
+ "root-not-runnable-on-elected-device": "root-not-runnable-on-elected-device";
733
+ }>;
734
+ }, z.core.$strip>, z.ZodObject<{
735
+ kind: z.ZodLiteral<"zone-driven">;
736
+ }, z.core.$strip>, z.ZodObject<{
737
+ kind: z.ZodLiteral<"supplied-by-root">;
738
+ rootModelId: z.ZodString;
739
+ }, z.core.$strip>, z.ZodObject<{
740
+ kind: z.ZodLiteral<"opt-in-unused">;
741
+ }, z.core.$strip>], "kind">;
742
+ export type StepSwitchCell = z.infer<typeof StepSwitchCellSchema>;
743
+ export declare const StepSwitchMatrixSchema: z.ZodObject<{
744
+ steps: z.ZodReadonly<z.ZodArray<z.ZodObject<{
745
+ stepId: z.ZodString;
746
+ name: z.ZodString;
747
+ slot: z.ZodString;
748
+ clusterMode: z.ZodNullable<z.ZodEnum<{
749
+ off: "off";
750
+ on: "on";
751
+ "opt-in": "opt-in";
752
+ }>>;
753
+ effectiveMode: z.ZodEnum<{
754
+ off: "off";
755
+ on: "on";
756
+ "opt-in": "opt-in";
757
+ }>;
758
+ camerasEnabling: z.ZodNumber;
759
+ camerasDisabling: z.ZodNumber;
760
+ nodes: z.ZodReadonly<z.ZodArray<z.ZodObject<{
761
+ nodeId: z.ZodString;
762
+ reachable: z.ZodBoolean;
763
+ stepEnabled: z.ZodNullable<z.ZodBoolean>;
764
+ devices: z.ZodReadonly<z.ZodArray<z.ZodObject<{
765
+ deviceKey: z.ZodString;
766
+ format: z.ZodEnum<{
767
+ coreml: "coreml";
768
+ gguf: "gguf";
769
+ onnx: "onnx";
770
+ openvino: "openvino";
771
+ pt: "pt";
772
+ tflite: "tflite";
773
+ }>;
774
+ stepEnabled: z.ZodNullable<z.ZodBoolean>;
775
+ eligible: z.ZodBoolean;
776
+ cell: z.ZodDiscriminatedUnion<[z.ZodObject<{
777
+ kind: z.ZodLiteral<"on">;
778
+ }, z.core.$strip>, z.ZodObject<{
779
+ kind: z.ZodLiteral<"off-cluster">;
780
+ }, z.core.$strip>, z.ZodObject<{
781
+ kind: z.ZodLiteral<"off-node">;
782
+ }, z.core.$strip>, z.ZodObject<{
783
+ kind: z.ZodLiteral<"off-device">;
784
+ }, z.core.$strip>, z.ZodObject<{
785
+ kind: z.ZodLiteral<"jump">;
786
+ toDeviceKey: z.ZodString;
787
+ }, z.core.$strip>, z.ZodObject<{
788
+ kind: z.ZodLiteral<"skip">;
789
+ reason: z.ZodEnum<{
790
+ "no-compatible-model": "no-compatible-model";
791
+ "root-not-runnable-on-elected-device": "root-not-runnable-on-elected-device";
792
+ }>;
793
+ }, z.core.$strip>, z.ZodObject<{
794
+ kind: z.ZodLiteral<"zone-driven">;
795
+ }, z.core.$strip>, z.ZodObject<{
796
+ kind: z.ZodLiteral<"supplied-by-root">;
797
+ rootModelId: z.ZodString;
798
+ }, z.core.$strip>, z.ZodObject<{
799
+ kind: z.ZodLiteral<"opt-in-unused">;
800
+ }, z.core.$strip>], "kind">;
801
+ }, z.core.$strip>>>;
802
+ }, z.core.$strip>>>;
803
+ }, z.core.$strip>>>;
804
+ }, z.core.$strip>;
805
+ export type StepSwitchMatrix = z.infer<typeof StepSwitchMatrixSchema>;
691
806
  /**
692
807
  * Pipeline Orchestrator capability — global load balancer + camera dispatcher.
693
808
  *
@@ -1079,6 +1194,7 @@ export declare const pipelineOrchestratorCapability: {
1079
1194
  "node-h": "node-h";
1080
1195
  }>>;
1081
1196
  stepSettings: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodReadonly<z.ZodRecord<z.ZodString, z.ZodUnknown>>>>;
1197
+ stepEnabled: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodBoolean>>;
1082
1198
  inferenceDevices: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
1083
1199
  enabled: z.ZodBoolean;
1084
1200
  weight: z.ZodOptional<z.ZodNumber>;
@@ -1087,6 +1203,7 @@ export declare const pipelineOrchestratorCapability: {
1087
1203
  modelId: z.ZodOptional<z.ZodString>;
1088
1204
  settings: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
1089
1205
  jumpDeviceKey: z.ZodOptional<z.ZodString>;
1206
+ enabled: z.ZodOptional<z.ZodBoolean>;
1090
1207
  }, z.core.$strip>>>;
1091
1208
  }, z.core.$strip>>>;
1092
1209
  }, z.core.$strip>>, import("./capability-definition.js").CapabilityMethodKind>;
@@ -1114,6 +1231,7 @@ export declare const pipelineOrchestratorCapability: {
1114
1231
  "node-h": "node-h";
1115
1232
  }>>;
1116
1233
  stepSettings: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodReadonly<z.ZodRecord<z.ZodString, z.ZodUnknown>>>>;
1234
+ stepEnabled: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodBoolean>>;
1117
1235
  inferenceDevices: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
1118
1236
  enabled: z.ZodBoolean;
1119
1237
  weight: z.ZodOptional<z.ZodNumber>;
@@ -1122,6 +1240,7 @@ export declare const pipelineOrchestratorCapability: {
1122
1240
  modelId: z.ZodOptional<z.ZodString>;
1123
1241
  settings: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
1124
1242
  jumpDeviceKey: z.ZodOptional<z.ZodString>;
1243
+ enabled: z.ZodOptional<z.ZodBoolean>;
1125
1244
  }, z.core.$strip>>>;
1126
1245
  }, z.core.$strip>>>;
1127
1246
  }, z.core.$strip>;
@@ -1242,6 +1361,7 @@ export declare const pipelineOrchestratorCapability: {
1242
1361
  modelId: z.ZodOptional<z.ZodString>;
1243
1362
  settings: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
1244
1363
  jumpDeviceKey: z.ZodOptional<z.ZodString>;
1364
+ enabled: z.ZodOptional<z.ZodBoolean>;
1245
1365
  }, z.core.$strip>>>;
1246
1366
  }, z.core.$strip>>;
1247
1367
  }, z.core.$strip>, z.ZodObject<{
@@ -1261,6 +1381,113 @@ export declare const pipelineOrchestratorCapability: {
1261
1381
  }, z.core.$strip>, z.ZodObject<{
1262
1382
  success: z.ZodLiteral<true>;
1263
1383
  }, z.core.$strip>, "mutation">;
1384
+ /**
1385
+ * Set one step's CLUSTER switch (D1065): `off` | `on` | `opt-in`, or
1386
+ * `null` to return to the catalog default. Re-resolves every placed
1387
+ * camera's pipeline.
1388
+ */
1389
+ readonly setClusterStepMode: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
1390
+ stepId: z.ZodString;
1391
+ mode: z.ZodNullable<z.ZodEnum<{
1392
+ off: "off";
1393
+ on: "on";
1394
+ "opt-in": "opt-in";
1395
+ }>>;
1396
+ }, z.core.$strip>, z.ZodObject<{
1397
+ success: z.ZodLiteral<true>;
1398
+ }, z.core.$strip>, "mutation">;
1399
+ /**
1400
+ * Set one step's NODE switch (D1065): `false` = the step never runs on a
1401
+ * camera whose pipeline runs on that node; `null` = inherit.
1402
+ */
1403
+ readonly setNodeStepEnabled: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
1404
+ agentNodeId: z.ZodString;
1405
+ stepId: z.ZodString;
1406
+ enabled: z.ZodNullable<z.ZodBoolean>;
1407
+ }, z.core.$strip>, z.ZodObject<{
1408
+ success: z.ZodLiteral<true>;
1409
+ }, z.core.$strip>, "mutation">;
1410
+ /**
1411
+ * Set one step's DEVICE switch (D1065) on `(node, deviceKey)`: `false` =
1412
+ * the step is not provisioned there (a detail step jumps to an allowed
1413
+ * sibling, else is skipped); `null` = inherit.
1414
+ */
1415
+ readonly setDeviceStepEnabled: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
1416
+ agentNodeId: z.ZodString;
1417
+ deviceKey: z.ZodString;
1418
+ stepId: z.ZodString;
1419
+ enabled: z.ZodNullable<z.ZodBoolean>;
1420
+ }, z.core.$strip>, z.ZodObject<{
1421
+ success: z.ZodLiteral<true>;
1422
+ }, z.core.$strip>, "mutation">;
1423
+ /**
1424
+ * The step switch matrix (D1065): per step, the cluster mode, how many
1425
+ * cameras turn it on / off, and per node and device the effective cell —
1426
+ * computed by the same placement function the attach path runs. The
1427
+ * inspector renders this; it never derives a cell itself.
1428
+ */
1429
+ readonly getStepSwitches: import("./capability-definition.js").CapabilityMethodSchema<z.ZodVoid, z.ZodObject<{
1430
+ steps: z.ZodReadonly<z.ZodArray<z.ZodObject<{
1431
+ stepId: z.ZodString;
1432
+ name: z.ZodString;
1433
+ slot: z.ZodString;
1434
+ clusterMode: z.ZodNullable<z.ZodEnum<{
1435
+ off: "off";
1436
+ on: "on";
1437
+ "opt-in": "opt-in";
1438
+ }>>;
1439
+ effectiveMode: z.ZodEnum<{
1440
+ off: "off";
1441
+ on: "on";
1442
+ "opt-in": "opt-in";
1443
+ }>;
1444
+ camerasEnabling: z.ZodNumber;
1445
+ camerasDisabling: z.ZodNumber;
1446
+ nodes: z.ZodReadonly<z.ZodArray<z.ZodObject<{
1447
+ nodeId: z.ZodString;
1448
+ reachable: z.ZodBoolean;
1449
+ stepEnabled: z.ZodNullable<z.ZodBoolean>;
1450
+ devices: z.ZodReadonly<z.ZodArray<z.ZodObject<{
1451
+ deviceKey: z.ZodString;
1452
+ format: z.ZodEnum<{
1453
+ coreml: "coreml";
1454
+ gguf: "gguf";
1455
+ onnx: "onnx";
1456
+ openvino: "openvino";
1457
+ pt: "pt";
1458
+ tflite: "tflite";
1459
+ }>;
1460
+ stepEnabled: z.ZodNullable<z.ZodBoolean>;
1461
+ eligible: z.ZodBoolean;
1462
+ cell: z.ZodDiscriminatedUnion<[z.ZodObject<{
1463
+ kind: z.ZodLiteral<"on">;
1464
+ }, z.core.$strip>, z.ZodObject<{
1465
+ kind: z.ZodLiteral<"off-cluster">;
1466
+ }, z.core.$strip>, z.ZodObject<{
1467
+ kind: z.ZodLiteral<"off-node">;
1468
+ }, z.core.$strip>, z.ZodObject<{
1469
+ kind: z.ZodLiteral<"off-device">;
1470
+ }, z.core.$strip>, z.ZodObject<{
1471
+ kind: z.ZodLiteral<"jump">;
1472
+ toDeviceKey: z.ZodString;
1473
+ }, z.core.$strip>, z.ZodObject<{
1474
+ kind: z.ZodLiteral<"skip">;
1475
+ reason: z.ZodEnum<{
1476
+ "no-compatible-model": "no-compatible-model";
1477
+ "root-not-runnable-on-elected-device": "root-not-runnable-on-elected-device";
1478
+ }>;
1479
+ }, z.core.$strip>, z.ZodObject<{
1480
+ kind: z.ZodLiteral<"zone-driven">;
1481
+ }, z.core.$strip>, z.ZodObject<{
1482
+ kind: z.ZodLiteral<"supplied-by-root">;
1483
+ rootModelId: z.ZodString;
1484
+ }, z.core.$strip>, z.ZodObject<{
1485
+ kind: z.ZodLiteral<"opt-in-unused">;
1486
+ }, z.core.$strip>], "kind">;
1487
+ }, z.core.$strip>>>;
1488
+ }, z.core.$strip>>>;
1489
+ }, z.core.$strip>>>;
1490
+ }, z.core.$strip>, import("./capability-definition.js").CapabilityMethodKind>;
1264
1491
  /**
1265
1492
  * DEVICE-AWARE merged view of ONE node's inference accelerators. Joins each
1266
1493
  * physical device the node HAS — probed live via a node-pinned
@@ -1304,11 +1531,13 @@ export declare const pipelineOrchestratorCapability: {
1304
1531
  modelId: z.ZodOptional<z.ZodString>;
1305
1532
  settings: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
1306
1533
  jumpDeviceKey: z.ZodOptional<z.ZodString>;
1534
+ enabled: z.ZodOptional<z.ZodBoolean>;
1307
1535
  }, z.core.$strip>>>;
1308
1536
  exclusion: z.ZodNullable<z.ZodEnum<{
1309
1537
  "accelerator-preferred": "accelerator-preferred";
1310
1538
  "cannot-host-camera-root": "cannot-host-camera-root";
1311
1539
  disabled: "disabled";
1540
+ "root-switched-off": "root-switched-off";
1312
1541
  unavailable: "unavailable";
1313
1542
  }>>;
1314
1543
  }, z.core.$strip>>>;
@@ -355,6 +355,7 @@ export declare const RunnerInferenceDeviceSchema: z.ZodObject<{
355
355
  modelId: z.ZodOptional<z.ZodString>;
356
356
  settings: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
357
357
  }, z.core.$strip>>>;
358
+ disabledSteps: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodString>>>;
358
359
  }, z.core.$strip>;
359
360
  export type RunnerInferenceDevice = z.infer<typeof RunnerInferenceDeviceSchema>;
360
361
  /**
@@ -457,6 +458,7 @@ declare const RunnerCameraConfigSchema: z.ZodObject<{
457
458
  modelId: z.ZodOptional<z.ZodString>;
458
459
  settings: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
459
460
  }, z.core.$strip>>>;
461
+ disabledSteps: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodString>>>;
460
462
  }, z.core.$strip>>>>;
461
463
  }, z.core.$strip>;
462
464
  /**
@@ -759,6 +761,7 @@ export declare const pipelineRunnerCapability: {
759
761
  modelId: z.ZodOptional<z.ZodString>;
760
762
  settings: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
761
763
  }, z.core.$strip>>>;
764
+ disabledSteps: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodString>>>;
762
765
  }, z.core.$strip>>>>;
763
766
  }, z.core.$strip>, z.ZodObject<{
764
767
  success: z.ZodLiteral<true>;
package/dist/client.js CHANGED
@@ -29934,6 +29934,10 @@ function createSystemProxy(api) {
29934
29934
  setAgentReachableHost: (input) => dispatch("pipelineOrchestrator", "setAgentReachableHost", "mutation", input),
29935
29935
  setAgentInferenceDevices: (input) => dispatch("pipelineOrchestrator", "setAgentInferenceDevices", "mutation", input),
29936
29936
  setNodeStepSettings: (input) => dispatch("pipelineOrchestrator", "setNodeStepSettings", "mutation", input),
29937
+ setClusterStepMode: (input) => dispatch("pipelineOrchestrator", "setClusterStepMode", "mutation", input),
29938
+ setNodeStepEnabled: (input) => dispatch("pipelineOrchestrator", "setNodeStepEnabled", "mutation", input),
29939
+ setDeviceStepEnabled: (input) => dispatch("pipelineOrchestrator", "setDeviceStepEnabled", "mutation", input),
29940
+ getStepSwitches: (input) => dispatch("pipelineOrchestrator", "getStepSwitches", "query", input),
29937
29941
  getNodeInferenceDevices: (input) => dispatch("pipelineOrchestrator", "getNodeInferenceDevices", "query", input),
29938
29942
  forgetInferenceDevice: (input) => dispatch("pipelineOrchestrator", "forgetInferenceDevice", "mutation", input),
29939
29943
  resetNodePipelineDefaults: (input) => dispatch("pipelineOrchestrator", "resetNodePipelineDefaults", "mutation", input),
package/dist/client.mjs CHANGED
@@ -29933,6 +29933,10 @@ function createSystemProxy(api) {
29933
29933
  setAgentReachableHost: (input) => dispatch("pipelineOrchestrator", "setAgentReachableHost", "mutation", input),
29934
29934
  setAgentInferenceDevices: (input) => dispatch("pipelineOrchestrator", "setAgentInferenceDevices", "mutation", input),
29935
29935
  setNodeStepSettings: (input) => dispatch("pipelineOrchestrator", "setNodeStepSettings", "mutation", input),
29936
+ setClusterStepMode: (input) => dispatch("pipelineOrchestrator", "setClusterStepMode", "mutation", input),
29937
+ setNodeStepEnabled: (input) => dispatch("pipelineOrchestrator", "setNodeStepEnabled", "mutation", input),
29938
+ setDeviceStepEnabled: (input) => dispatch("pipelineOrchestrator", "setDeviceStepEnabled", "mutation", input),
29939
+ getStepSwitches: (input) => dispatch("pipelineOrchestrator", "getStepSwitches", "query", input),
29936
29940
  getNodeInferenceDevices: (input) => dispatch("pipelineOrchestrator", "getNodeInferenceDevices", "query", input),
29937
29941
  forgetInferenceDevice: (input) => dispatch("pipelineOrchestrator", "forgetInferenceDevice", "mutation", input),
29938
29942
  resetNodePipelineDefaults: (input) => dispatch("pipelineOrchestrator", "resetNodePipelineDefaults", "mutation", input),
@@ -8,6 +8,10 @@ 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
10
  import type { NativeCapOptions } from './command-hold.js';
11
+ /** Options of `fetchDevice`. `fresh` re-reads the binding instead of serving the per-context cache. */
12
+ export interface FetchDeviceOptions {
13
+ readonly fresh?: boolean;
14
+ }
11
15
  /** What a device states about the config it persists. */
12
16
  export interface DevicePersistConfigOptions {
13
17
  /** Dotted paths its schema declares secret (`collectZodSecretPaths`). */
@@ -80,7 +84,7 @@ export interface DeviceContext {
80
84
  * Always wired by the production context factory; test ctx
81
85
  * fixtures supply a stub.
82
86
  */
83
- readonly fetchDevice: (deviceId: number) => Promise<DeviceProxy>;
87
+ readonly fetchDevice: (deviceId: number, options?: FetchDeviceOptions) => Promise<DeviceProxy>;
84
88
  /**
85
89
  * Reverse-pointer hook called by `BaseDevice` constructor right
86
90
  * after building its `runtimeState`. The kernel context factory
@@ -10,7 +10,7 @@ import type { HeroSceneMode } from './hero-scene.js';
10
10
  import type { HeroState } from './hero-state.js';
11
11
  import type { HeroText } from './hero-text.js';
12
12
  /** Which cap a state reading comes from; `STATE_SOURCE_ORDER` ranks them. */
13
- export type StateSource = 'media-player' | 'dishwasher' | 'lock-control' | 'alarm-panel' | 'vacuum-control' | 'lawn-mower-control' | 'fan-control' | 'pet-feeder' | 'pet-fountain' | 'automation-control' | 'script-runner' | 'event-emitter' | 'running-state' | 'switch' | 'contact' | 'group-active' | 'cover' | 'valve' | 'humidifier' | 'brightness' | 'smoke' | 'flood' | 'gas' | 'tamper' | 'vibration' | 'doorbell' | 'motion' | 'presence' | 'update' | 'weather' | 'image' | 'control' | 'meter' | 'binary' | 'button' | 'climate-control' | 'sensor';
13
+ export type StateSource = 'media-player' | 'dishwasher' | 'lock-control' | 'alarm-panel' | 'vacuum-control' | 'lawn-mower-control' | 'fan-control' | 'pet-feeder' | 'pet-fountain' | 'automation-control' | 'script-runner' | 'event-emitter' | 'running-state' | 'workload' | 'switch' | 'contact' | 'group-active' | 'cover' | 'valve' | 'humidifier' | 'brightness' | 'smoke' | 'flood' | 'gas' | 'tamper' | 'vibration' | 'doorbell' | 'motion' | 'presence' | 'update' | 'weather' | 'image' | 'control' | 'meter' | 'binary' | 'button' | 'climate-control' | 'sensor';
14
14
  export interface StateReading {
15
15
  readonly source: StateSource;
16
16
  readonly state: HeroState;
@@ -12,7 +12,7 @@ export type { ExposeBlockDevicesInput, ReconcileBlockDevicesInput, } from './blo
12
12
  export { exposeBlockDevices, reconcileBlockDevices } from './block-declared-devices.js';
13
13
  export type { IDevice } from './device.js';
14
14
  export { DeviceConfig } from './device-config.js';
15
- export type { DeviceConstructor, DeviceContext, DeviceManagerApi, DevicePersistConfigOptions, IDeviceRegistry, IDeviceRegistryReader, } from './device-context.js';
15
+ export type { DeviceConstructor, DeviceContext, DeviceManagerApi, DevicePersistConfigOptions, FetchDeviceOptions, IDeviceRegistry, IDeviceRegistryReader, } from './device-context.js';
16
16
  export type { ChildLayout, ChildLayoutEntry, CreateDeviceSpec, DeviceDiscovery, DeviceManualCreation, DeviceMeta, DiscoveredDevice, InitialDeviceMeta, SavedDevice, } from './device-management.js';
17
17
  export { DEVICE_IDENTIFIER_KEYS, DeviceIdentifierEntrySchema, DeviceIdentifierKeySchema, DeviceIdentifierOriginSchema, DeviceIdentifiersSchema, identifierStrength, isEmptyIdentifiers, mergeIdentifiers, normaliseIdentifiers, sameIdentifiers, normaliseMac, } from './device-identifiers.js';
18
18
  export type { AcceptedValue, DeviceIdentifierEntry, DeviceIdentifierKey, DeviceIdentifierOrigin, DeviceIdentifiers, DeviceIdentifierStrength, NormaliseIdentifiersOptions, NormalisedIdentifiers, NormaliseResult, RawDeviceIdentifiers, RawSerialIdentifier, RawVendorUidIdentifier, RejectedIdentifier, RejectedReason, } from './device-identifiers.js';