@camstack/types 1.2.318 → 1.2.319

package/dist/addon.js

@@ -156,9 +156,9 @@ var CAP_INPUT_DEFAULTS = Object.freeze({
 		"searchObjectEvents": { "limit": 50 }
 	},
 	"pipeline-orchestrator": {
-		"applyBestSettings": { "headroom": .4 },
+		"applyAutoTune": { "headroom": .4 },
 		"getPlacementStats": { "windowMs": 36e5 },
-		"planBestSettings": { "headroom": .4 },
+		"planAutoTune": { "headroom": .4 },
 		"setLoadBalancingShares": {
 			"nodes": {},
 			"devices": {}

package/dist/addon.mjs

@@ -155,9 +155,9 @@ var CAP_INPUT_DEFAULTS = Object.freeze({
 		"searchObjectEvents": { "limit": 50 }
 	},
 	"pipeline-orchestrator": {
-		"applyBestSettings": { "headroom": .4 },
+		"applyAutoTune": { "headroom": .4 },
 		"getPlacementStats": { "windowMs": 36e5 },
-		"planBestSettings": { "headroom": .4 },
+		"planAutoTune": { "headroom": .4 },
 		"setLoadBalancingShares": {
 			"nodes": {},
 			"devices": {}

package/dist/capabilities/pipeline-executor.cap.d.ts

@@ -822,7 +822,7 @@ export declare const pipelineExecutorCapability: {
             clearedDevices: z.ZodNumber;
         }, z.core.$strip>, "mutation">;
         /**
-         * Best settings (D745): the MODEL-BOUND thresholds (`bindsToModel` keys of
+         * Auto tune (D745): the MODEL-BOUND thresholds (`bindsToModel` keys of
          * the object-detection root, and their binding keys) stored in THIS node's
          * per-camera detector settings — and, unless `dryRun`, remove them so the
          * running model's own defaults apply. Every other key of a camera's store

package/dist/capabilities/pipeline-orchestrator.cap.d.ts

@@ -1326,7 +1326,7 @@ export declare const pipelineOrchestratorCapability: {
             clearedCameraOverrides: z.ZodNumber;
         }, z.core.$strip>, "mutation">;
         /**
-         * Best settings (D745) — DRY RUN. Recommends ONE detector family (YOLOv9)
+         * Auto tune (D745) — DRY RUN. Recommends ONE detector family (YOLOv9)
          * for the whole cluster from each node's static hardware class, the
          * measured latency table and the detection demand, and lists every write
          * the apply would make: the node model pins set, the enrichment pins and
@@ -1335,7 +1335,7 @@ export declare const pipelineOrchestratorCapability: {
          * enablement, device enablement, pins, recording, notifications, zones and
          * rules are never part of it. `planHash` names exactly this diff.
          */
-        readonly planBestSettings: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
+        readonly planAutoTune: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
             headroom: z.ZodDefault<z.ZodNumber>;
             shares: z.ZodOptional<z.ZodObject<{
                 nodes: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodNumber>>;
@@ -1549,12 +1549,12 @@ export declare const pipelineOrchestratorCapability: {
             }, z.core.$strip>], "kind">>>;
         }, z.core.$strip>, import("./capability-definition.js").CapabilityMethodKind>;
         /**
-         * Best settings (D745) — APPLY the plan the operator confirmed. Recomputes
+         * Auto tune (D745) — APPLY the plan the operator confirmed. Recomputes
          * the plan and refuses (`stale`, with the fresh plan) when its hash is not
          * `planHash`, so what is written is exactly the confirmed diff. Offline
          * nodes are skipped; there is no undo.
          */
-        readonly applyBestSettings: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
+        readonly applyAutoTune: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
             planHash: z.ZodString;
             headroom: z.ZodDefault<z.ZodNumber>;
         }, z.core.$strip>, z.ZodDiscriminatedUnion<[z.ZodObject<{
@@ -1856,7 +1856,7 @@ export declare const pipelineOrchestratorCapability: {
         }, z.core.$strip>, import("./capability-definition.js").CapabilityMethodKind>;
         /**
          * Load balancing (D748) — shares proportional to each node's measured
-         * capacity at the models Best settings would pick, iterated (≤ 3 rounds)
+         * capacity at the models Auto tune would pick, iterated (≤ 3 rounds)
          * until the shares stop moving; per device, an ADVISORY session cap.
          * Writes nothing.
          */
@@ -1881,6 +1881,52 @@ export declare const pipelineOrchestratorCapability: {
                 skippedReason: z.ZodNullable<z.ZodString>;
             }, z.core.$strip>>>;
         }, z.core.$strip>, import("./capability-definition.js").CapabilityMethodKind>;
+        /**
+         * Load balancing (D750) — the shares placement reads now: the source
+         * (automatic capacity shares or the operator's sliders), each node's and
+         * device's configured share, and the effective share after a node or
+         * device that cannot take sessions gave its share to the others.
+         */
+        readonly getEffectiveShares: import("./capability-definition.js").CapabilityMethodSchema<z.ZodVoid, z.ZodObject<{
+            source: z.ZodEnum<{
+                manual: "manual";
+                auto: "auto";
+            }>;
+            policy: z.ZodEnum<{
+                "least-loaded": "least-loaded";
+                share: "share";
+            }>;
+            autoPending: z.ZodBoolean;
+            computedAt: z.ZodNullable<z.ZodNumber>;
+            trigger: z.ZodNullable<z.ZodString>;
+            nodes: z.ZodReadonly<z.ZodArray<z.ZodObject<{
+                nodeId: z.ZodString;
+                eligible: z.ZodBoolean;
+                configuredPct: z.ZodNumber;
+                effectivePct: z.ZodNumber;
+                devices: z.ZodReadonly<z.ZodArray<z.ZodObject<{
+                    deviceKey: z.ZodString;
+                    eligible: z.ZodBoolean;
+                    configuredPct: z.ZodNumber;
+                    effectivePct: z.ZodNumber;
+                }, z.core.$strip>>>;
+            }, z.core.$strip>>>;
+            nodeWeights: z.ZodRecord<z.ZodString, z.ZodNumber>;
+            deviceWeights: z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodNumber>>;
+        }, z.core.$strip>, import("./capability-definition.js").CapabilityMethodKind>;
+        /**
+         * Load balancing (D750) — switch between automatic and manual shares.
+         * Going manual seeds the sliders with the current automatic shares (one
+         * atomic write), so nothing jumps; going automatic recomputes at once.
+         */
+        readonly setShareSource: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
+            source: z.ZodEnum<{
+                manual: "manual";
+                auto: "auto";
+            }>;
+        }, z.core.$strip>, z.ZodObject<{
+            success: z.ZodLiteral<true>;
+        }, z.core.$strip>, "mutation">;
         /** Read one camera's settings. Null when never touched (inherits agent defaults fully). */
         readonly getCameraSettings: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
             deviceId: z.ZodNumber;

package/dist/client.js

@@ -7499,11 +7499,13 @@ function createSystemProxy(api) {
 			setAgentInferenceDevices: (input) => dispatch("pipelineOrchestrator", "setAgentInferenceDevices", "mutation", input),
 			getNodeInferenceDevices: (input) => dispatch("pipelineOrchestrator", "getNodeInferenceDevices", "query", input),
 			resetNodePipelineDefaults: (input) => dispatch("pipelineOrchestrator", "resetNodePipelineDefaults", "mutation", input),
-			planBestSettings: (input) => dispatch("pipelineOrchestrator", "planBestSettings", "query", input),
-			applyBestSettings: (input) => dispatch("pipelineOrchestrator", "applyBestSettings", "mutation", input),
+			planAutoTune: (input) => dispatch("pipelineOrchestrator", "planAutoTune", "query", input),
+			applyAutoTune: (input) => dispatch("pipelineOrchestrator", "applyAutoTune", "mutation", input),
 			setLoadBalancingShares: (input) => dispatch("pipelineOrchestrator", "setLoadBalancingShares", "mutation", input),
 			getPlacementStats: (input) => dispatch("pipelineOrchestrator", "getPlacementStats", "query", input),
 			suggestShares: (input) => dispatch("pipelineOrchestrator", "suggestShares", "query", input),
+			getEffectiveShares: (input) => dispatch("pipelineOrchestrator", "getEffectiveShares", "query", input),
+			setShareSource: (input) => dispatch("pipelineOrchestrator", "setShareSource", "mutation", input),
 			getCameraStatuses: (input) => dispatch("pipelineOrchestrator", "getCameraStatuses", "query", input),
 			setCameraSensors: (input) => dispatch("pipelineOrchestrator", "setCameraSensors", "mutation", input),
 			reconcileFromDisk: (input) => dispatch("pipelineOrchestrator", "reconcileFromDisk", "mutation", input),

package/dist/client.mjs

@@ -7498,11 +7498,13 @@ function createSystemProxy(api) {
 			setAgentInferenceDevices: (input) => dispatch("pipelineOrchestrator", "setAgentInferenceDevices", "mutation", input),
 			getNodeInferenceDevices: (input) => dispatch("pipelineOrchestrator", "getNodeInferenceDevices", "query", input),
 			resetNodePipelineDefaults: (input) => dispatch("pipelineOrchestrator", "resetNodePipelineDefaults", "mutation", input),
-			planBestSettings: (input) => dispatch("pipelineOrchestrator", "planBestSettings", "query", input),
-			applyBestSettings: (input) => dispatch("pipelineOrchestrator", "applyBestSettings", "mutation", input),
+			planAutoTune: (input) => dispatch("pipelineOrchestrator", "planAutoTune", "query", input),
+			applyAutoTune: (input) => dispatch("pipelineOrchestrator", "applyAutoTune", "mutation", input),
 			setLoadBalancingShares: (input) => dispatch("pipelineOrchestrator", "setLoadBalancingShares", "mutation", input),
 			getPlacementStats: (input) => dispatch("pipelineOrchestrator", "getPlacementStats", "query", input),
 			suggestShares: (input) => dispatch("pipelineOrchestrator", "suggestShares", "query", input),
+			getEffectiveShares: (input) => dispatch("pipelineOrchestrator", "getEffectiveShares", "query", input),
+			setShareSource: (input) => dispatch("pipelineOrchestrator", "setShareSource", "mutation", input),
 			getCameraStatuses: (input) => dispatch("pipelineOrchestrator", "getCameraStatuses", "query", input),
 			setCameraSensors: (input) => dispatch("pipelineOrchestrator", "setCameraSensors", "mutation", input),
 			reconcileFromDisk: (input) => dispatch("pipelineOrchestrator", "reconcileFromDisk", "mutation", input),

package/dist/generated/addon-api.d.ts

@@ -6595,18 +6595,18 @@ export type AppRouter = TrpcCoreRouter<{
             output: z.infer<typeof pipelineOrchestratorCapability.methods.resetNodePipelineDefaults.output>;
             meta: object;
         }>;
-        planBestSettings: TRPCQueryProcedure<{
+        planAutoTune: TRPCQueryProcedure<{
             input: {
                 [x: string]: unknown;
-            } & z.input<typeof pipelineOrchestratorCapability.methods.planBestSettings.input>;
-            output: z.infer<typeof pipelineOrchestratorCapability.methods.planBestSettings.output>;
+            } & z.input<typeof pipelineOrchestratorCapability.methods.planAutoTune.input>;
+            output: z.infer<typeof pipelineOrchestratorCapability.methods.planAutoTune.output>;
             meta: object;
         }>;
-        applyBestSettings: TRPCMutationProcedure<{
+        applyAutoTune: TRPCMutationProcedure<{
             input: {
                 [x: string]: unknown;
-            } & z.input<typeof pipelineOrchestratorCapability.methods.applyBestSettings.input>;
-            output: z.infer<typeof pipelineOrchestratorCapability.methods.applyBestSettings.output>;
+            } & z.input<typeof pipelineOrchestratorCapability.methods.applyAutoTune.input>;
+            output: z.infer<typeof pipelineOrchestratorCapability.methods.applyAutoTune.output>;
             meta: object;
         }>;
         setLoadBalancingShares: TRPCMutationProcedure<{
@@ -6630,6 +6630,20 @@ export type AppRouter = TrpcCoreRouter<{
             output: z.infer<typeof pipelineOrchestratorCapability.methods.suggestShares.output>;
             meta: object;
         }>;
+        getEffectiveShares: TRPCQueryProcedure<{
+            input: {
+                nodeId?: string | undefined;
+            } | undefined;
+            output: z.infer<typeof pipelineOrchestratorCapability.methods.getEffectiveShares.output>;
+            meta: object;
+        }>;
+        setShareSource: TRPCMutationProcedure<{
+            input: {
+                [x: string]: unknown;
+            } & z.input<typeof pipelineOrchestratorCapability.methods.setShareSource.input>;
+            output: z.infer<typeof pipelineOrchestratorCapability.methods.setShareSource.output>;
+            meta: object;
+        }>;
         getCameraSettings: TRPCQueryProcedure<{
             input: {
                 [x: string]: unknown;

package/dist/generated/method-access-map.d.ts

@@ -6,7 +6,7 @@
  * scope+access check inside `protectedProcedure` (see
  * `server/backend/src/api/trpc/trpc.middleware.ts`).
  *
- * Coverage: 1232 method paths across 165 capabilities.
+ * Coverage: 1234 method paths across 165 capabilities.
  */
 import type { CapabilityMethodAccess } from '../capabilities/capability-definition.js';
 export interface MethodAccessRecord {

package/dist/generated/system-proxy.d.ts

@@ -88,7 +88,7 @@ export interface SystemProxy {
     readonly notificationRules: Pick<InferProvider<typeof notificationRulesCapability>, 'listRules' | 'getRule' | 'createRule' | 'updateRule' | 'deleteRule' | 'setRuleEnabled' | 'listSequences' | 'getSequence' | 'createSequence' | 'updateSequence' | 'deleteSequence' | 'getClipRetentionAsks' | 'listDeviceMutes' | 'testRule' | 'previewStateSummary' | 'getConditionCatalog' | 'getTemplateCatalog' | 'previewTemplate' | 'getHistory' | 'getRuleLastRuns' | 'resolveArtifactUrl' | 'listSnoozes' | 'createSnooze' | 'cancelSnooze' | 'getAlarmConfig' | 'setAlarmConfig' | 'createAlarmProfile' | 'renameAlarmProfile' | 'deleteAlarmProfile' | 'activateAlarmProfile' | 'getAlarmSensors'>;
     readonly osdManager: Pick<InferProvider<typeof osdManagerCapability>, 'getConditionSupport' | 'copyDeviceConfiguration' | 'listTemplates' | 'upsertTemplate' | 'deleteTemplate'>;
     readonly pipelineExecutor: Pick<InferProvider<typeof pipelineExecutorCapability>, 'getAvailableEngines' | 'getSelectedEngine' | 'getDefaultSteps' | 'getEngineProvisioning' | 'getVideoPipelineSteps' | 'setVideoPipelineSteps' | 'clearDeviceOverrides' | 'clearModelBoundDeviceOverrides' | 'getInferenceDeviceHealth' | 'rearmInferenceDevice' | 'getSchema' | 'getGlobalSteps' | 'getGlobalPipelineConfig' | 'getOrchestratorConfigSchema' | 'validatePipeline' | 'listTemplates' | 'saveTemplate' | 'updateTemplate' | 'deleteTemplate' | 'getCapabilities' | 'getAddonModels' | 'downloadModel' | 'deleteModel' | 'cacheFrameInPool' | 'inferCached' | 'uncacheFrame' | 'getEffectiveTuning' | 'listLoadedEngines' | 'spinEngine' | 'killEngine' | 'listReferenceImages' | 'getReferenceImage' | 'getReferenceAudioFiles' | 'getReferenceAudio' | 'getAudioCapabilities' | 'runAudioTest' | 'getDetectionConfigSchema'>;
-    readonly pipelineOrchestrator: Pick<InferProvider<typeof pipelineOrchestratorCapability>, 'requestOccupancyLook' | 'pauseForStorageMigration' | 'resumeForStorageMigration' | 'rebalance' | 'getPipelineAssignments' | 'getAgentLoad' | 'getClusterModelChoice' | 'getGlobalMetrics' | 'getCapabilityBindings' | 'setCapabilityBinding' | 'getIngestOwner' | 'getAudioNodeLoad' | 'getAudioAssignments' | 'getAgentSettings' | 'listAgentSettings' | 'removeAgentSettings' | 'setAgentMaxCameras' | 'setAgentCapabilities' | 'setAgentDecodeLimits' | 'setAgentReachableHost' | 'setAgentInferenceDevices' | 'getNodeInferenceDevices' | 'resetNodePipelineDefaults' | 'planBestSettings' | 'applyBestSettings' | 'setLoadBalancingShares' | 'getPlacementStats' | 'suggestShares' | 'getCameraStatuses' | 'setCameraSensors' | 'reconcileFromDisk' | 'getReconcileFromDiskStatus' | 'listTemplates' | 'saveTemplate' | 'updateTemplate' | 'deleteTemplate'>;
+    readonly pipelineOrchestrator: Pick<InferProvider<typeof pipelineOrchestratorCapability>, 'requestOccupancyLook' | 'pauseForStorageMigration' | 'resumeForStorageMigration' | 'rebalance' | 'getPipelineAssignments' | 'getAgentLoad' | 'getClusterModelChoice' | 'getGlobalMetrics' | 'getCapabilityBindings' | 'setCapabilityBinding' | 'getIngestOwner' | 'getAudioNodeLoad' | 'getAudioAssignments' | 'getAgentSettings' | 'listAgentSettings' | 'removeAgentSettings' | 'setAgentMaxCameras' | 'setAgentCapabilities' | 'setAgentDecodeLimits' | 'setAgentReachableHost' | 'setAgentInferenceDevices' | 'getNodeInferenceDevices' | 'resetNodePipelineDefaults' | 'planAutoTune' | 'applyAutoTune' | 'setLoadBalancingShares' | 'getPlacementStats' | 'suggestShares' | 'getEffectiveShares' | 'setShareSource' | 'getCameraStatuses' | 'setCameraSensors' | 'reconcileFromDisk' | 'getReconcileFromDiskStatus' | 'listTemplates' | 'saveTemplate' | 'updateTemplate' | 'deleteTemplate'>;
     readonly pipelineRunner: Pick<InferProvider<typeof pipelineRunnerCapability>, 'attachCamera' | 'reportMotion' | 'getLocalLoad' | 'getLocalMetrics' | 'getAllCameraMetrics' | 'getLocalCameras' | 'getNativeCrop' | 'runStatelessStep'>;
     readonly plateGallery: Pick<InferProvider<typeof plateGalleryCapability>, 'getPlateMedia' | 'searchPlates' | 'suggestPlateClusters' | 'correctPlateText' | 'deletePlate' | 'listVehicles' | 'createVehicle' | 'renameVehicle' | 'deleteVehicle' | 'listVehicleSamples' | 'removeVehicleSample' | 'assignPlate' | 'unassignPlate' | 'assignPlates' | 'unassignPlates'>;
     readonly recordingArchive: Pick<InferProvider<typeof recordingArchiveCapability>, 'getAvailabilityBatch' | 'getDaysWithRecordingsBatch' | 'getStorageUsage' | 'listOpsLog' | 'pauseForStorageMigration' | 'resumeForStorageMigration' | 'refreshStorageLocationsForMigration' | 'startStorageMigrationMove' | 'getStorageMigrationMoveStatus' | 'cancelStorageMigrationMove' | 'relocateFootage' | 'listRelocateJobs' | 'getRelocateResidue' | 'reconcileLedgerAgainstDisk' | 'cancelRelocateJob' | 'planStorageRebalance' | 'startStorageRebalance' | 'getPlacement' | 'setDevicePlacement'>;

package/dist/index.d.ts

@@ -268,7 +268,7 @@ export { type ProviderMotionData, ProviderMotionDataSchema, providerMotionEvent,
 export { type FormatRunnableModel, stepModelRunsOnFormat, } from './pipeline/step-format-runnable.js';
 export { isRemovedModelId, REMOVED_MODEL_IDS } from './pipeline/removed-model-ids.js';
 export { applyModelBoundSettings, clearModelBoundOverrides, clearModelBoundSetting, collectModelBoundKeys, hasModelBoundOverrides, type InapplicableModelBoundOverride, modelBindingKey, type ModelBoundSettingsBag, type ModelBoundSettingSource, type ModelBoundSettingState, resolveModelBoundSetting, writeModelBoundSetting, } from './pipeline/model-bound-settings.js';
-export * from './pipeline/best-settings/index.js';
+export * from './pipeline/auto-tune/index.js';
 export * from './pipeline/load-balancing/index.js';
 export { deriveRootFaceRefineRect, ROOT_FACE_REFINE_INPUT_PX, ROOT_FACE_REFINE_SCALE, } from './pipeline/root-face-crop.js';
 export { DEFAULT_DETAIL_CROP_CONVENTION, DETAIL_CROP_PADDING_FIELD, DETAIL_CROP_PADDING_KEY, DETAIL_CROP_SECTION_ID, DETAIL_CROP_SQUARE_KEY, type DetailCropConvention, DetailCropConventionSchema, type DetailCropRect, deriveDetailCropRect, FULL_IMAGE_BBOX, type HydratedSettingsSection, type HydratedSettingsView, pickDetailCropConvention, readDetailCropConvention, } from './pipeline/detail-crop.js';