@camstack/types 1.2.307 → 1.2.309

package/dist/capabilities/custom-model-registry.cap.d.ts

@@ -169,7 +169,8 @@ export declare const CustomModelDescriptorSchema: z.ZodObject<{
             }>>;
             preserveOriginal: z.ZodBoolean;
         }, z.core.$strip>>;
-        fillsClassifierEffects: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodObject<{
+        suppliesSteps: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            kind: z.ZodLiteral<"label">;
             stepId: z.ZodEnum<{
                 "animal-classifier": "animal-classifier";
                 "vehicle-classifier": "vehicle-classifier";
@@ -177,7 +178,23 @@ export declare const CustomModelDescriptorSchema: z.ZodObject<{
             }>;
             labelToEffect: z.ZodRecord<z.ZodString, z.ZodString>;
             uncovered: z.ZodReadonly<z.ZodArray<z.ZodString>>;
-        }, z.core.$strip>>>>;
+        }, z.core.$strip>, z.ZodObject<{
+            kind: z.ZodLiteral<"crop">;
+            stepId: z.ZodEnum<{
+                "plate-detection": "plate-detection";
+                "face-detection": "face-detection";
+            }>;
+            rootLabels: z.ZodReadonly<z.ZodArray<z.ZodString>>;
+            parentMacro: z.ZodEnum<{
+                person: "person";
+                vehicle: "vehicle";
+            }>;
+            childClass: z.ZodEnum<{
+                face: "face";
+                plate: "plate";
+            }>;
+            rootInputPx: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>], "kind">>>>;
         clip: z.ZodOptional<z.ZodObject<{
             textModelId: z.ZodString;
             embeddingDim: z.ZodNumber;
@@ -357,7 +374,8 @@ export declare const customModelRegistryCapability: {
                     }>>;
                     preserveOriginal: z.ZodBoolean;
                 }, z.core.$strip>>;
-                fillsClassifierEffects: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodObject<{
+                suppliesSteps: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+                    kind: z.ZodLiteral<"label">;
                     stepId: z.ZodEnum<{
                         "animal-classifier": "animal-classifier";
                         "vehicle-classifier": "vehicle-classifier";
@@ -365,7 +383,23 @@ export declare const customModelRegistryCapability: {
                     }>;
                     labelToEffect: z.ZodRecord<z.ZodString, z.ZodString>;
                     uncovered: z.ZodReadonly<z.ZodArray<z.ZodString>>;
-                }, z.core.$strip>>>>;
+                }, z.core.$strip>, z.ZodObject<{
+                    kind: z.ZodLiteral<"crop">;
+                    stepId: z.ZodEnum<{
+                        "plate-detection": "plate-detection";
+                        "face-detection": "face-detection";
+                    }>;
+                    rootLabels: z.ZodReadonly<z.ZodArray<z.ZodString>>;
+                    parentMacro: z.ZodEnum<{
+                        person: "person";
+                        vehicle: "vehicle";
+                    }>;
+                    childClass: z.ZodEnum<{
+                        face: "face";
+                        plate: "plate";
+                    }>;
+                    rootInputPx: z.ZodOptional<z.ZodNumber>;
+                }, z.core.$strip>], "kind">>>>;
                 clip: z.ZodOptional<z.ZodObject<{
                     textModelId: z.ZodString;
                     embeddingDim: z.ZodNumber;

package/dist/capabilities/device-manager.cap.d.ts

@@ -781,8 +781,6 @@ export declare const deviceManagerCapability: {
             locationKey: z.ZodString;
             icon: z.ZodEnum<{
                 package: "package";
-                car: "car";
-                umbrella: "umbrella";
                 "map-pin": "map-pin";
                 house: "house";
                 "door-open": "door-open";
@@ -791,9 +789,11 @@ export declare const deviceManagerCapability: {
                 "bed-double": "bed-double";
                 bath: "bath";
                 briefcase: "briefcase";
+                car: "car";
                 "circle-parking": "circle-parking";
                 route: "route";
                 trees: "trees";
+                umbrella: "umbrella";
                 "waves-ladder": "waves-ladder";
                 fence: "fence";
                 warehouse: "warehouse";
@@ -815,8 +815,6 @@ export declare const deviceManagerCapability: {
             location: z.ZodString;
             icon: z.ZodNullable<z.ZodEnum<{
                 package: "package";
-                car: "car";
-                umbrella: "umbrella";
                 "map-pin": "map-pin";
                 house: "house";
                 "door-open": "door-open";
@@ -825,9 +823,11 @@ export declare const deviceManagerCapability: {
                 "bed-double": "bed-double";
                 bath: "bath";
                 briefcase: "briefcase";
+                car: "car";
                 "circle-parking": "circle-parking";
                 route: "route";
                 trees: "trees";
+                umbrella: "umbrella";
                 "waves-ladder": "waves-ladder";
                 fence: "fence";
                 warehouse: "warehouse";
@@ -882,8 +882,6 @@ export declare const deviceManagerCapability: {
             label: z.ZodString;
             icon: z.ZodNullable<z.ZodEnum<{
                 package: "package";
-                car: "car";
-                umbrella: "umbrella";
                 "map-pin": "map-pin";
                 house: "house";
                 "door-open": "door-open";
@@ -892,9 +890,11 @@ export declare const deviceManagerCapability: {
                 "bed-double": "bed-double";
                 bath: "bath";
                 briefcase: "briefcase";
+                car: "car";
                 "circle-parking": "circle-parking";
                 route: "route";
                 trees: "trees";
+                umbrella: "umbrella";
                 "waves-ladder": "waves-ladder";
                 fence: "fence";
                 warehouse: "warehouse";
@@ -915,8 +915,6 @@ export declare const deviceManagerCapability: {
             name: z.ZodString;
             icon: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
                 package: "package";
-                car: "car";
-                umbrella: "umbrella";
                 "map-pin": "map-pin";
                 house: "house";
                 "door-open": "door-open";
@@ -925,9 +923,11 @@ export declare const deviceManagerCapability: {
                 "bed-double": "bed-double";
                 bath: "bath";
                 briefcase: "briefcase";
+                car: "car";
                 "circle-parking": "circle-parking";
                 route: "route";
                 trees: "trees";
+                umbrella: "umbrella";
                 "waves-ladder": "waves-ladder";
                 fence: "fence";
                 warehouse: "warehouse";

package/dist/capabilities/hub-address.d.ts

@@ -0,0 +1,76 @@
+/**
+ * hub-address — the ONE reading of "at which address is this hub reached?",
+ * taken from the hub's own `local-network` palette (`getConnectionEndpoints`).
+ *
+ * There is no environment variable for this answer. The hub enumerates its
+ * interfaces, knows its own listen port, honours the operator's allowlist and
+ * knows its tunnel and mesh names — every input the answer needs. A variable
+ * that restated it could only drift from it: a Mac hub (whose desktop app has
+ * no field for one) and any container started without it handed agents
+ * `https://127.0.0.1:4443`, an address that names the AGENT, so every addon and
+ * model pull failed with a connection refused that looked like a network fault.
+ *
+ * Two audiences, because they reach the hub from different places:
+ *
+ * - `cluster` — another node or a LAN device dialling the hub: an agent
+ *   pulling a staged addon bundle or model, a camera relay told where the
+ *   broker is. A LAN IPv4 literal first (a `.local` name or an operator
+ *   hostname may not resolve inside an agent's container), then any other
+ *   plausible LAN address, then the mesh. Never a public tunnel: it is a
+ *   detour off the LAN for traffic that never left it, and tunnels cap bodies.
+ * - `browser` — a person's browser or a third party coming back to the hub: a
+ *   magic-link e-mail, an OIDC callback, the WebAuthn relying party, an OAuth2
+ *   `hubUrl` claim. The public tunnel, then the mesh, then the LAN.
+ *
+ * Both answers exclude loopback and the CamStack app link, always: loopback
+ * names whoever dials it, and the app link is not a hub address. `null` means
+ * the palette offered nothing usable — the caller must say so rather than
+ * substitute `127.0.0.1`.
+ *
+ * ## The operator override
+ *
+ * Auto-detection sees the hub's own interfaces, which is not always what the
+ * other side dials: a container on Docker BRIDGE networking sees only its
+ * 172.17.x, and a hub behind NAT or a VPN is reached at an address it never
+ * holds. For that, each audience has ONE stored override on the Network page
+ * (a `local-network` setting, never an environment variable). When set it wins
+ * outright; empty is automatic. It is validated on write by
+ * {@link validateHubAddressOverride} — http(s), no credentials, never loopback.
+ */
+import type { ConnectionEndpoint } from './local-network.cap.js';
+export type HubAddressAudience = 'cluster' | 'browser';
+export type HubAddressOverrideCheck = {
+    readonly ok: true;
+    readonly baseUrl: string;
+} | {
+    readonly ok: false;
+    readonly reason: string;
+};
+/**
+ * Validate an operator-typed override: an http(s) URL with a host, no
+ * credentials, no path, and never loopback (it would name whoever dials it).
+ * Answers the normalised origin (`scheme://host[:port]`).
+ */
+export declare function validateHubAddressOverride(raw: string): HubAddressOverrideCheck;
+/** Where a resolved hub address came from. */
+export type HubAddressSource = 'override' | 'auto' | 'none';
+export interface HubAddressResolution {
+    /** The operator's stored override, or `null` for automatic. */
+    readonly override: string | null;
+    /** The address in use, or `null` when nothing qualifies. */
+    readonly resolved: string | null;
+    readonly source: HubAddressSource;
+}
+/**
+ * The hub's base URL for `audience`, without a trailing slash, or `null` when
+ * the palette holds nothing that audience can reach. A valid operator
+ * `override` wins outright; an empty one means automatic. Ties inside a rank
+ * go to the palette's own `priority` (its preferred interface first).
+ */
+export declare function pickHubBaseUrl(endpoints: readonly ConnectionEndpoint[], audience: HubAddressAudience, override?: string | null): string | null;
+/** {@link pickHubBaseUrl}, saying where the answer came from. */
+export declare function resolveHubAddress(endpoints: readonly ConnectionEndpoint[], audience: HubAddressAudience, override: string | null): HubAddressResolution;
+/** The bare hostname of {@link pickHubBaseUrl}'s answer, or `null`. */
+export declare function pickHubHostname(endpoints: readonly ConnectionEndpoint[], audience: HubAddressAudience, override?: string | null): string | null;
+/** The bare hostname of a base URL, or `null` when it does not parse. */
+export declare function hubAddressHostname(baseUrl: string | null): string | null;

package/dist/capabilities/index.d.ts

@@ -64,6 +64,7 @@ export { EMBEDDING_MODEL_FAILED, EMBEDDING_REQUIREMENTS_FAILED, EMBEDDING_REQUIR
 export type { FailureContribution, IFailureContributionProvider, } from './failure-contribution.cap.js';
 export { FailureContributionSchema, FailureReasonCountSchema, failureContributionCapability, } from './failure-contribution.cap.js';
 export { filesystemBrowseCapability, type IFilesystemBrowseProvider, } from './filesystem-browse.cap.js';
+export { type HubAddressAudience, type HubAddressOverrideCheck, type HubAddressResolution, type HubAddressSource, hubAddressHostname, pickHubBaseUrl, pickHubHostname, resolveHubAddress, validateHubAddressOverride, } from './hub-address.js';
 export { type HfModelResolution, HfModelResolutionSchema, type ILlmProvider, type LlmDefault, LlmDefaultSchema, type LlmDefaultSelector, LlmDefaultSelectorSchema, type LlmProfile, type LlmProfileKind, type LlmProfileKindDescriptor, LlmProfileKindDescriptorSchema, LlmProfileKindSchema, LlmProfileSchema, type LlmRuntimeNode, LlmRuntimeNodeSchema, type LlmUsageRollup, LlmUsageRollupSchema, llmCapability, type ManagedModelCatalogEntry, ManagedModelCatalogEntrySchema, } from './llm.cap.js';
 export { type AppleFmAvailability, AppleFmAvailabilitySchema, type AppleFmUnavailableReason, AppleFmUnavailableReasonSchema, type ILlmRuntimeProvider, type LlmDownloadProgress, LlmDownloadProgressSchema, type LlmNodeModel, LlmNodeModelSchema, type LlmRuntimeAppleCompleteInput, LlmRuntimeAppleCompleteInputSchema, type LlmRuntimeCancelInput, LlmRuntimeCancelInputSchema, type LlmRuntimeCompleteInput, LlmRuntimeCompleteInputSchema, type LlmRuntimeDiskUsage, LlmRuntimeDiskUsageSchema, type LlmRuntimeStatus, LlmRuntimeStatusSchema, llmRuntimeCapability, type ManagedModelExtraFile, ManagedModelExtraFileSchema, type ManagedModelRef, ManagedModelRefSchema, type ManagedRuntimeConfig, ManagedRuntimeConfigSchema, } from './llm-runtime.cap.js';
 export { type LlmErrorCode, LlmErrorCodeSchema, type LlmGenerateBaseInput, LlmGenerateBaseInputSchema, type LlmGenerateErr, LlmGenerateErrSchema, type LlmGenerateOk, LlmGenerateOkSchema, type LlmGenerateResult, LlmGenerateResultSchema, type LlmImage, LlmImageSchema, type LlmRefusalSource, LlmRefusalSourceSchema, type LlmRetryPolicy, LlmRetryPolicySchema, LlmTimeoutDefaults, type LlmUsage, LlmUsageSchema, } from './llm-shared.js';
@@ -89,8 +90,8 @@ export { type Attachment, type AttachmentMediaType, AttachmentMediaTypeSchema, A
 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_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_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, NC_TANK_SYSTEM_EVENT_KINDS, type NcActionBinding, NcActionBindingSchema, 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 NcHookBindings, NcHookBindingsSchema, type NcLegacyRuleActionSequence, NcLegacyRuleActionSequenceSchema, type NcLinkedCameraMode, NcLinkedCameraModeSchema, type NcMediaFrame, NcMediaFrameSchema, type NcMediaPolicy, NcMediaPolicySchema, type NcOccupancyCondition, NcOccupancyConditionSchema, type NcPlateMatcher, NcPlateMatcherSchema, type NcRule, type NcRuleAction, NcRuleActionSchema, type NcRuleActionSequence, NcRuleActionSequenceSchema, type NcRuleActions, NcRuleActionsSchema, type NcRuleClearableKey, NcRuleClearableKeySchema, type NcRuleInput, NcRuleInputSchema, NcRuleKindSchema, type NcRuleLastRun, NcRuleLastRunSchema, type NcRuleLastRuns, NcRuleLastRunsSchema, type NcRuleNotificationButton, NcRuleNotificationButtonSchema, type NcRulePatch, NcRulePatchSchema, NcRuleSchema, type NcRuleTarget, NcRuleTargetSchema, type NcRuleUpdateInput, NcRuleUpdateInputSchema, type NcSceneCondition, NcSceneConditionSchema, type NcSchedule, NcScheduleSchema, type NcScheduleWindow, NcScheduleWindowSchema, type NcSensorTransition, NcSensorTransitionSchema, type NcSharedSequence, type NcSharedSequenceInput, NcSharedSequenceInputSchema, NcSharedSequenceSchema, type NcSnooze, type NcSnoozeInput, NcSnoozeInputSchema, NcSnoozeSchema, type NcSnoozeScope, NcSnoozeScopeSchema, type NcSnoozeSuppressed, NcSnoozeSuppressedSchema, type NcStateSummaryPreview, type NcStateSummaryPreviewRow, NcStateSummaryPreviewRowSchema, NcStateSummaryPreviewSchema, type NcStateSummaryPreviewSection, NcStateSummaryPreviewSectionSchema, type NcStateSummarySectionId, NcStateSummarySectionIdSchema, type NcStateSummarySplit, NcStateSummarySplitSchema, type NcSystemEventCondition, NcSystemEventConditionSchema, type NcSystemEventDelivery, type NcSystemEventDeliveryMode, NcSystemEventDeliveryModeSchema, NcSystemEventDeliverySchema, type NcSystemEventKind, NcSystemEventKindSchema, 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';
 export { type IOauthIntegrationProvider, type OauthIntegrationDescriptor, OauthIntegrationDescriptorSchema, oauthIntegrationCapability, } from './oauth-integration.cap.js';
 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 RetrainAnnotation, type RetrainAnnotationDraft, RetrainAnnotationDraftSchema, RetrainAnnotationKindSchema, RetrainAnnotationSchema, RetrainAnnotationSourceSchema, type RetrainAssistResult, RetrainAssistResultSchema, RetrainAssistSubjectSchema, RetrainCopyRefusalSchema, type RetrainFrame, type RetrainFrameCandidate, RetrainFrameCandidateSchema, type RetrainFrameList, RetrainFrameListSchema, RetrainFrameSchema, type RetrainFrameSelection, RetrainFrameSelectionSchema, type RetrainMacroClass, RetrainMacroClassSchema, type RetrainStatus, RetrainStatusSchema, type RetrainTrack, RetrainTrackSchema, type RetrainTransitionResult, RetrainTransitionResultSchema, type ScoredObjectEvent, ScoredObjectEventSchema, type SensorEvent, SensorEventSchema, type Track, type TrackCascadeCounts, TrackCascadeCountsSchema, type TrackEnvelope, TrackEnvelopeSchema, TrackedDetectionSchema, type TrackFlags, type TrackFlagsPatch, TrackFlagsPatchSchema, TrackFlagsSchema, 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';
-export type { EffectiveTuning, EffectiveTuningInput, NativeCropRef, PipelineStepInputOutput, PipelineValidationIssue, PipelineValidationResult, } from './pipeline-executor.cap.js';
-export { EffectiveTuningSchema, ModelSubstitutionSchema, NativeCropRefSchema, PipelineDefaultStepSchema, PipelineEngineChoiceSchema, PipelineRunResultBridge, PipelineStepInputSchema, PipelineValidationIssueSchema, PipelineValidationResultSchema, pipelineExecutorCapability, } from './pipeline-executor.cap.js';
+export type { EffectiveTuning, EffectiveTuningInput, NativeCropRef, PipelineStepInputOutput, SuppliedRootOutput, PipelineValidationIssue, PipelineValidationResult, } from './pipeline-executor.cap.js';
+export { EffectiveTuningSchema, ModelSubstitutionSchema, NativeCropRefSchema, PipelineDefaultStepSchema, PipelineEngineChoiceSchema, PipelineRunResultBridge, PipelineStepInputSchema, PipelineValidationIssueSchema, PipelineValidationResultSchema, SuppliedRootOutputSchema, pipelineExecutorCapability, } from './pipeline-executor.cap.js';
 export type { CameraAssignmentStatus, CameraAudioStatus, CameraBrokerProfile, CameraBrokerStatus, CameraDecoderShm, CameraDecoderStatus, CameraDetectionPhase, CameraDetectionProvisioning, CameraDetectionProvisioningState, CameraDetectionStatus, CameraMotionStatus, CameraRecordingMode, CameraRecordingStatus, CameraSourceStatus, CameraSourceStream, CameraStatus, CameraStatusDegradation, CameraStatusDegradationReason, CameraStatusStage, ClusterModelChoice, ClusterModelChoiceUnreadableReason, DiskReconcileJob, InferenceDeviceExclusionReason, IngestOwner, NodeInferenceDevice, NodeInferenceDevices, OccupancyLookAnswer, OccupancyLookRefusal, OccupancyLookRequest, SetCameraSensorsInput, } from './pipeline-orchestrator.cap.js';
 export { AgentLoadSummarySchema, CameraAssignmentStatusSchema, CameraAudioStatusSchema, CameraBrokerProfileSchema, CameraBrokerStatusSchema, CameraDecoderShmSchema, CameraDecoderStatusSchema, 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';
 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';
@@ -174,7 +175,7 @@ export { type BacklightMode, BacklightModeSchema, type ExposureMode, ExposureMod
 export { AvailableIntegrationTypeSchema, CreateIntegrationInputSchema, DeleteIntegrationResultSchema, type IIntegrationsProvider, IntegrationLiteSchema, type IntegrationTestConnectionResult, type IntegrationTestConnectionStatus, IntegrationWithStateSchema, integrationsCapability, TestConnectionResultSchema, TestConnectionStatusEnum, UpdateIntegrationInputSchema, } from './integrations.cap.js';
 export { type IIntercomProvider, type IntercomAbility, IntercomAbilitySchema, type IntercomStatus, IntercomStatusSchema, intercomCapability, } from './intercom.cap.js';
 export { type DeviceCodeSeverity, DeviceCodeSeveritySchema, type ILawnMowerControlProvider, type LawnMowerActivity, LawnMowerActivitySchema, type LawnMowerControlStatus, LawnMowerControlStatusSchema, lawnMowerControlCapability, } from './lawn-mower-control.cap.js';
-export { type AdvertisedLocalPort, type ConnectionEndpoint, type ILocalNetworkProvider, type LocalInterface, localNetworkCapability, type NotificationEndpoint, } from './local-network.cap.js';
+export { type AdvertisedLocalPort, type ConnectionEndpoint, type HubAddresses, type HubAddressSnapshot, type ILocalNetworkProvider, type LocalInterface, localNetworkCapability, type NotificationEndpoint, } from './local-network.cap.js';
 export { type ILockControlProvider, type LockControlStatus, LockControlStatusSchema, type LockState, LockStateSchema, lockControlCapability, } from './lock-control.cap.js';
 export { type MaskGridDims, MaskGridDimsSchema, type MaskGridShape, MaskGridShapeSchema, type MaskLineShape, MaskLineShapeSchema, type MaskPoint, MaskPointSchema, type MaskPolygonShape, MaskPolygonShapeSchema, type MaskPolygonVertices, MaskPolygonVerticesSchema, type MaskRectShape, MaskRectShapeSchema, type MaskShape, type MaskShapeKind, MaskShapeKindSchema, MaskShapeSchema, } from './mask-shape.js';
 export { type IMediaPlayerProvider, type MediaInfo, type MediaPlayerRepeat, MediaPlayerRepeatSchema, type MediaPlayerState, MediaPlayerStateSchema, type MediaPlayerStatus, MediaPlayerStatusSchema, mediaPlayerCapability, } from './media-player.cap.js';

package/dist/capabilities/local-network.cap.d.ts

@@ -107,6 +107,41 @@ declare const ViewerEndpointsSchema: z.ZodObject<{
     resolved: z.ZodReadonly<z.ZodArray<z.ZodString>>;
 }, z.core.$strip>;
 export type ViewerEndpoints = z.infer<typeof ViewerEndpointsSchema>;
+/**
+ * One audience's hub address (see `hub-address.ts`): the operator's stored
+ * override, the address in use, and where it came from.
+ */
+declare const HubAddressSnapshotSchema: z.ZodObject<{
+    override: z.ZodNullable<z.ZodString>;
+    resolved: z.ZodNullable<z.ZodString>;
+    source: z.ZodEnum<{
+        none: "none";
+        override: "override";
+        auto: "auto";
+    }>;
+}, z.core.$strip>;
+declare const HubAddressesSchema: z.ZodObject<{
+    cluster: z.ZodObject<{
+        override: z.ZodNullable<z.ZodString>;
+        resolved: z.ZodNullable<z.ZodString>;
+        source: z.ZodEnum<{
+            none: "none";
+            override: "override";
+            auto: "auto";
+        }>;
+    }, z.core.$strip>;
+    browser: z.ZodObject<{
+        override: z.ZodNullable<z.ZodString>;
+        resolved: z.ZodNullable<z.ZodString>;
+        source: z.ZodEnum<{
+            none: "none";
+            override: "override";
+            auto: "auto";
+        }>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export type HubAddresses = z.infer<typeof HubAddressesSchema>;
+export type HubAddressSnapshot = z.infer<typeof HubAddressSnapshotSchema>;
 export declare const localNetworkCapability: {
     readonly name: "local-network";
     readonly scope: "system";
@@ -299,6 +334,64 @@ export declare const localNetworkCapability: {
             baseUrls: z.ZodReadonly<z.ZodArray<z.ZodString>>;
             resolved: z.ZodReadonly<z.ZodArray<z.ZodString>>;
         }, z.core.$strip>, "mutation">;
+        /**
+         * The hub's address for each audience — agents (`cluster`) and sign-in
+         * links (`browser`) — as every consumer must read it: the operator's
+         * override when set, else the automatic pick from this cap's palette,
+         * never loopback. The ONE answer to "at which address is this hub
+         * reached?"; there is no environment variable for it.
+         */
+        readonly getHubAddresses: import("./capability-definition.js").CapabilityMethodSchema<z.ZodVoid, z.ZodObject<{
+            cluster: z.ZodObject<{
+                override: z.ZodNullable<z.ZodString>;
+                resolved: z.ZodNullable<z.ZodString>;
+                source: z.ZodEnum<{
+                    none: "none";
+                    override: "override";
+                    auto: "auto";
+                }>;
+            }, z.core.$strip>;
+            browser: z.ZodObject<{
+                override: z.ZodNullable<z.ZodString>;
+                resolved: z.ZodNullable<z.ZodString>;
+                source: z.ZodEnum<{
+                    none: "none";
+                    override: "override";
+                    auto: "auto";
+                }>;
+            }, z.core.$strip>;
+        }, z.core.$strip>, import("./capability-definition.js").CapabilityMethodKind>;
+        /**
+         * Set or clear (`baseUrl: null`) one audience's override. Validated: an
+         * http(s) origin with a host, no credentials, no path, never loopback —
+         * an invalid value is refused with the reason, nothing is stored.
+         */
+        readonly setHubAddress: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
+            audience: z.ZodEnum<{
+                cluster: "cluster";
+                browser: "browser";
+            }>;
+            baseUrl: z.ZodNullable<z.ZodString>;
+        }, z.core.$strip>, z.ZodObject<{
+            cluster: z.ZodObject<{
+                override: z.ZodNullable<z.ZodString>;
+                resolved: z.ZodNullable<z.ZodString>;
+                source: z.ZodEnum<{
+                    none: "none";
+                    override: "override";
+                    auto: "auto";
+                }>;
+            }, z.core.$strip>;
+            browser: z.ZodObject<{
+                override: z.ZodNullable<z.ZodString>;
+                resolved: z.ZodNullable<z.ZodString>;
+                source: z.ZodEnum<{
+                    none: "none";
+                    override: "override";
+                    auto: "auto";
+                }>;
+            }, z.core.$strip>;
+        }, z.core.$strip>, "mutation">;
         /**
          * Read the operator's allowlist. Empty = "auto" (no filter). Used
          * by the admin UI's address selector to seed its checkbox state.

package/dist/capabilities/model-convert.cap.d.ts

@@ -279,7 +279,8 @@ export declare const modelConvertCapability: {
                     }>>;
                     preserveOriginal: z.ZodBoolean;
                 }, z.core.$strip>>;
-                fillsClassifierEffects: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodObject<{
+                suppliesSteps: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+                    kind: z.ZodLiteral<"label">;
                     stepId: z.ZodEnum<{
                         "animal-classifier": "animal-classifier";
                         "vehicle-classifier": "vehicle-classifier";
@@ -287,7 +288,23 @@ export declare const modelConvertCapability: {
                     }>;
                     labelToEffect: z.ZodRecord<z.ZodString, z.ZodString>;
                     uncovered: z.ZodReadonly<z.ZodArray<z.ZodString>>;
-                }, z.core.$strip>>>>;
+                }, z.core.$strip>, z.ZodObject<{
+                    kind: z.ZodLiteral<"crop">;
+                    stepId: z.ZodEnum<{
+                        "plate-detection": "plate-detection";
+                        "face-detection": "face-detection";
+                    }>;
+                    rootLabels: z.ZodReadonly<z.ZodArray<z.ZodString>>;
+                    parentMacro: z.ZodEnum<{
+                        person: "person";
+                        vehicle: "vehicle";
+                    }>;
+                    childClass: z.ZodEnum<{
+                        face: "face";
+                        plate: "plate";
+                    }>;
+                    rootInputPx: z.ZodOptional<z.ZodNumber>;
+                }, z.core.$strip>], "kind">>>>;
                 clip: z.ZodOptional<z.ZodObject<{
                     textModelId: z.ZodString;
                     embeddingDim: z.ZodNumber;

package/dist/capabilities/model-distributor.cap.d.ts

@@ -177,7 +177,8 @@ export declare const ModelDistributeInputSchema: z.ZodObject<{
             }>>;
             preserveOriginal: z.ZodBoolean;
         }, z.core.$strip>>;
-        fillsClassifierEffects: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodObject<{
+        suppliesSteps: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            kind: z.ZodLiteral<"label">;
             stepId: z.ZodEnum<{
                 "animal-classifier": "animal-classifier";
                 "vehicle-classifier": "vehicle-classifier";
@@ -185,7 +186,23 @@ export declare const ModelDistributeInputSchema: z.ZodObject<{
             }>;
             labelToEffect: z.ZodRecord<z.ZodString, z.ZodString>;
             uncovered: z.ZodReadonly<z.ZodArray<z.ZodString>>;
-        }, z.core.$strip>>>>;
+        }, z.core.$strip>, z.ZodObject<{
+            kind: z.ZodLiteral<"crop">;
+            stepId: z.ZodEnum<{
+                "plate-detection": "plate-detection";
+                "face-detection": "face-detection";
+            }>;
+            rootLabels: z.ZodReadonly<z.ZodArray<z.ZodString>>;
+            parentMacro: z.ZodEnum<{
+                person: "person";
+                vehicle: "vehicle";
+            }>;
+            childClass: z.ZodEnum<{
+                face: "face";
+                plate: "plate";
+            }>;
+            rootInputPx: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>], "kind">>>>;
         clip: z.ZodOptional<z.ZodObject<{
             textModelId: z.ZodString;
             embeddingDim: z.ZodNumber;
@@ -370,7 +387,8 @@ export declare const modelDistributorCapability: {
                     }>>;
                     preserveOriginal: z.ZodBoolean;
                 }, z.core.$strip>>;
-                fillsClassifierEffects: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodObject<{
+                suppliesSteps: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+                    kind: z.ZodLiteral<"label">;
                     stepId: z.ZodEnum<{
                         "animal-classifier": "animal-classifier";
                         "vehicle-classifier": "vehicle-classifier";
@@ -378,7 +396,23 @@ export declare const modelDistributorCapability: {
                     }>;
                     labelToEffect: z.ZodRecord<z.ZodString, z.ZodString>;
                     uncovered: z.ZodReadonly<z.ZodArray<z.ZodString>>;
-                }, z.core.$strip>>>>;
+                }, z.core.$strip>, z.ZodObject<{
+                    kind: z.ZodLiteral<"crop">;
+                    stepId: z.ZodEnum<{
+                        "plate-detection": "plate-detection";
+                        "face-detection": "face-detection";
+                    }>;
+                    rootLabels: z.ZodReadonly<z.ZodArray<z.ZodString>>;
+                    parentMacro: z.ZodEnum<{
+                        person: "person";
+                        vehicle: "vehicle";
+                    }>;
+                    childClass: z.ZodEnum<{
+                        face: "face";
+                        plate: "plate";
+                    }>;
+                    rootInputPx: z.ZodOptional<z.ZodNumber>;
+                }, z.core.$strip>], "kind">>>>;
                 clip: z.ZodOptional<z.ZodObject<{
                     textModelId: z.ZodString;
                     embeddingDim: z.ZodNumber;