@camstack/addon-pipeline 1.2.340 → 1.2.341

package/dist/audio-analyzer/index.js

@@ -3,9 +3,9 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 const require_chunk = require("../chunk-emK7D4bc.js");
-const require_dist = require("../dist-BWigCRRN.js");
-const require_model_catalogs = require("../model-catalogs-BFBf8sHb.js");
-const require_process_memory = require("../process-memory-C9U6dKxS.js");
+const require_dist = require("../dist-PiNPe8uQ.js");
+const require_model_catalogs = require("../model-catalogs-CEphd9Va.js");
+const require_process_memory = require("../process-memory-CzAfDP9P.js");
 let node_fs = require("node:fs");
 node_fs = require_chunk.__toESM(node_fs);
 let node_path = require("node:path");

package/dist/audio-analyzer/index.mjs

@@ -1,7 +1,7 @@
 import { n as __require } from "../chunk-DnnnRqeS.mjs";
-import { Dn as errMsg, In as expandAudioChunkToF32le, Ln as hydrateSchema, Mn as audioChunkBytesPerSample, N as PoolMemoryWatchdog, Nt as mapAudioLabelToMacro, Vn as nodePin, X as audioAnalyzerCapability, Y as audioAnalysisCapability, an as resolvePoolMemoryPolicy, h as DEFAULT_AUDIO_ANALYZER_CONFIG, ir as EventCategory, kn as BaseAddon, r as AUDIO_BACKEND_CHOICES } from "../dist-CsA6fY6I.mjs";
-import { n as AUDIO_CLASSIFIER_MODELS } from "../model-catalogs-D7JXV0_i.mjs";
-import { n as pickNodePlatformArch, t as readProcessMemory } from "../process-memory-DOEeg2pL.mjs";
+import { Dn as errMsg, In as expandAudioChunkToF32le, Ln as hydrateSchema, Mn as audioChunkBytesPerSample, N as PoolMemoryWatchdog, Nt as mapAudioLabelToMacro, Vn as nodePin, X as audioAnalyzerCapability, Y as audioAnalysisCapability, an as resolvePoolMemoryPolicy, h as DEFAULT_AUDIO_ANALYZER_CONFIG, ir as EventCategory, kn as BaseAddon, r as AUDIO_BACKEND_CHOICES } from "../dist-B8oPeJDI.mjs";
+import { n as AUDIO_CLASSIFIER_MODELS } from "../model-catalogs-RM3pkuZm.mjs";
+import { n as pickNodePlatformArch, t as readProcessMemory } from "../process-memory-C4v8DBKn.mjs";
 import * as fs from "node:fs";
 import * as path$1 from "node:path";
 import { ensureModel } from "@camstack/system/addon-utils";

package/dist/{custom-model-catalog-Cjbll1Sf.js → custom-model-catalog-CoJEC8nz.js}

@@ -1,5 +1,5 @@
-const require_dist = require("./dist-BWigCRRN.js");
-const require_model_catalogs = require("./model-catalogs-BFBf8sHb.js");
+const require_dist = require("./dist-PiNPe8uQ.js");
+const require_model_catalogs = require("./model-catalogs-CEphd9Va.js");
 const require_worker_protocol = require("./worker-protocol-C-G8qmye.js");
 let node_crypto = require("node:crypto");
 //#region src/detection-pipeline/registry/effective-confidence.ts

package/dist/{custom-model-catalog-BOnN63HU.mjs → custom-model-catalog-DNSmyZTT.mjs}

@@ -1,5 +1,5 @@
-import { Dt as inferModelProvider, Z as audioKindId, b as DEVICE_BACKEND_TO_FORMAT, f as COCO_80_LABELS, i as AUDIO_MACRO_LABELS, k as LABEL_SUPPLY_VOCABULARIES, p as COCO_TO_MACRO, un as stepModelRunsOnFormat } from "./dist-CsA6fY6I.mjs";
-import { a as FACE_DETECTION_MODELS, c as OBJECT_DETECTION_MODELS, d as PLATE_OCR_MODELS, f as SEGMENTATION_REFINER_MODELS, i as CLIP_EMBEDDING_MODELS, l as PACKAGE_DETECTION_MODELS, n as AUDIO_CLASSIFIER_MODELS, o as FACE_EMBEDDING_MODELS, p as VEHICLE_CLASSIFIER_MODELS, r as BIRD_CLASSIFIER_MODELS, s as INSTANCE_SEGMENTATION_MODELS, t as ANIMAL_CLASSIFIER_MODELS, u as PLATE_DETECTION_MODELS } from "./model-catalogs-D7JXV0_i.mjs";
+import { Dt as inferModelProvider, Z as audioKindId, b as DEVICE_BACKEND_TO_FORMAT, f as COCO_80_LABELS, i as AUDIO_MACRO_LABELS, k as LABEL_SUPPLY_VOCABULARIES, p as COCO_TO_MACRO, un as stepModelRunsOnFormat } from "./dist-B8oPeJDI.mjs";
+import { a as FACE_DETECTION_MODELS, c as OBJECT_DETECTION_MODELS, d as PLATE_OCR_MODELS, f as SEGMENTATION_REFINER_MODELS, i as CLIP_EMBEDDING_MODELS, l as PACKAGE_DETECTION_MODELS, n as AUDIO_CLASSIFIER_MODELS, o as FACE_EMBEDDING_MODELS, p as VEHICLE_CLASSIFIER_MODELS, r as BIRD_CLASSIFIER_MODELS, s as INSTANCE_SEGMENTATION_MODELS, t as ANIMAL_CLASSIFIER_MODELS, u as PLATE_DETECTION_MODELS } from "./model-catalogs-RM3pkuZm.mjs";
 import { t as isWorkerReply } from "./worker-protocol-D_NzPcnh.mjs";
 import { randomUUID } from "node:crypto";
 //#region src/detection-pipeline/registry/effective-confidence.ts

package/dist/detection-pipeline/index.js

@@ -3,11 +3,11 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 const require_chunk = require("../chunk-emK7D4bc.js");
-const require_dist = require("../dist-BWigCRRN.js");
-const require_node = require("../node-D52HHrVZ.js");
-const require_custom_model_catalog = require("../custom-model-catalog-Cjbll1Sf.js");
+const require_dist = require("../dist-PiNPe8uQ.js");
+const require_node = require("../node-CMTBIa3-.js");
+const require_custom_model_catalog = require("../custom-model-catalog-CoJEC8nz.js");
 const require_lazy_sharp = require("../lazy-sharp-BuwKlQLR.js");
-const require_process_memory = require("../process-memory-C9U6dKxS.js");
+const require_process_memory = require("../process-memory-CzAfDP9P.js");
 let node_os = require("node:os");
 node_os = require_chunk.__toESM(node_os);
 let node_fs = require("node:fs");
@@ -348,7 +348,7 @@ function normalizeEngineNodeId(rawNodeId) {
 //#endregion
 //#region src/detection-pipeline/model-bound-device-overrides.ts
 /**
-* Best settings (D745), the executor leg: list — and optionally remove — the
+* Auto tune (D745), the executor leg: list — and optionally remove — the
 * MODEL-BOUND thresholds stored in this addon's per-camera settings (the
 * object-detection root's `bindsToModel` keys and their binding keys, D738).
 * Every other key of a camera's store is kept.
@@ -8554,7 +8554,7 @@ var DetectionPipelineProvider = class DetectionPipelineProvider {
 	readDeviceStore;
 	/** Delete all per-device settings for a device (used by `clearDeviceOverrides`). */
 	clearDeviceStore;
-	/** Merge a patch into one device's settings (Best settings' keep-the-rest rewrite, D745). */
+	/** Merge a patch into one device's settings (Auto tune' keep-the-rest rewrite, D745). */
 	writeDeviceStore;
 	/**
 	* The per-device overrides the FRAME path reads, kept fresh off that path.
@@ -11155,7 +11155,7 @@ var DetectionPipelineProvider = class DetectionPipelineProvider {
 		};
 	}
 	/**
-	* Best settings (D745): list — or, unless `dryRun`, remove — the model-bound
+	* Auto tune (D745): list — or, unless `dryRun`, remove — the model-bound
 	* thresholds of the per-camera detector store. See
 	* `model-bound-device-overrides.ts`.
 	*/
@@ -11172,14 +11172,14 @@ var DetectionPipelineProvider = class DetectionPipelineProvider {
 			invalidate: (deviceId) => this.deviceOverrides.invalidate(deviceId),
 			boundKeys: require_dist.collectModelBoundKeys(require_custom_model_catalog.getStep("object-detection").getConfigSchema())
 		}, input);
-		if (!input.dryRun) for (const entry of result.entries) this.log.info("best settings: per-camera detector thresholds cleared", {
+		if (!input.dryRun) for (const entry of result.entries) this.log.info("auto tune: per-camera detector thresholds cleared", {
 			tags: { deviceId: entry.deviceId },
 			meta: {
 				deviceId: entry.deviceId,
 				keys: entry.keys
 			}
 		});
-		for (const r of result.refused) this.log.warn("best settings: per-camera detector thresholds not cleared", {
+		for (const r of result.refused) this.log.warn("auto tune: per-camera detector thresholds not cleared", {
 			tags: { deviceId: r.deviceId },
 			meta: {
 				deviceId: r.deviceId,

package/dist/detection-pipeline/index.mjs

@@ -1,9 +1,9 @@
 import { n as __require } from "../chunk-DnnnRqeS.mjs";
-import { $n as object, Bt as modelBindingKey, Dn as errMsg$1, Et as hfModelUrl, G as YAMNET_TO_MACRO, Gn as sleep, Hn as parseJsonUnknown, Ht as overlayClusterStepSettings, J as applyModelBoundSettings, Ln as hydrateSchema, N as PoolMemoryWatchdog, Nn as createEvent, O as LABEL_SUPPLY_MACRO, Vn as nodePin, Wt as pickClusterStepSettings, _t as evaluateZoneRules, an as resolvePoolMemoryPolicy, cn as rootSuppliesOf, ct as defaultDeviceFor$1, d as CLUSTER_MODEL_SCOPED_STEPS, en as resolveClusterStepModelId, g as DEFAULT_CLUSTER_STEP_SETTINGS, gt as enumerateInferenceDevices, hn as supportedRuntimes$1, ir as EventCategory, it as containingParentIndex, jt as loadContributionCapability, kn as BaseAddon, kt as linkedLabelStepId, ln as runtimeDevices$1, n as APPLE_SA_TO_MACRO, nr as string, pt as detectionPipelineCapability, qn as array, qt as pipelineExecutorCapability, rr as union, rt as collectModelBoundKeys, un as stepModelRunsOnFormat } from "../dist-CsA6fY6I.mjs";
-import { s as readProcessCost } from "../node-BZ29vHq2.mjs";
-import { C as resolveModelDefaultConfidence, S as landmarkPrecisionVerdict, _ as ALL_STEPS, b as getStepDefinition, f as localFrameRegistry, g as ALL_PIPELINE_STEPS, l as resolveDefaultDetectionModel, n as mergeCustomModels, o as deviceKeyOf, r as buildSubtreeCanRun, s as resolveDeviceEngine, t as CustomModelCatalog, u as macroGateVerdict, v as getDefaultModelForFormat, x as resolveModelForFormat, y as getStep } from "../custom-model-catalog-BOnN63HU.mjs";
+import { $n as object, Bt as modelBindingKey, Dn as errMsg$1, Et as hfModelUrl, G as YAMNET_TO_MACRO, Gn as sleep, Hn as parseJsonUnknown, Ht as overlayClusterStepSettings, J as applyModelBoundSettings, Ln as hydrateSchema, N as PoolMemoryWatchdog, Nn as createEvent, O as LABEL_SUPPLY_MACRO, Vn as nodePin, Wt as pickClusterStepSettings, _t as evaluateZoneRules, an as resolvePoolMemoryPolicy, cn as rootSuppliesOf, ct as defaultDeviceFor$1, d as CLUSTER_MODEL_SCOPED_STEPS, en as resolveClusterStepModelId, g as DEFAULT_CLUSTER_STEP_SETTINGS, gt as enumerateInferenceDevices, hn as supportedRuntimes$1, ir as EventCategory, it as containingParentIndex, jt as loadContributionCapability, kn as BaseAddon, kt as linkedLabelStepId, ln as runtimeDevices$1, n as APPLE_SA_TO_MACRO, nr as string, pt as detectionPipelineCapability, qn as array, qt as pipelineExecutorCapability, rr as union, rt as collectModelBoundKeys, un as stepModelRunsOnFormat } from "../dist-B8oPeJDI.mjs";
+import { s as readProcessCost } from "../node-DFUmMJ_f.mjs";
+import { C as resolveModelDefaultConfidence, S as landmarkPrecisionVerdict, _ as ALL_STEPS, b as getStepDefinition, f as localFrameRegistry, g as ALL_PIPELINE_STEPS, l as resolveDefaultDetectionModel, n as mergeCustomModels, o as deviceKeyOf, r as buildSubtreeCanRun, s as resolveDeviceEngine, t as CustomModelCatalog, u as macroGateVerdict, v as getDefaultModelForFormat, x as resolveModelForFormat, y as getStep } from "../custom-model-catalog-DNSmyZTT.mjs";
 import { t as getSharp } from "../lazy-sharp-DXsqwpph.mjs";
-import { n as pickNodePlatformArch, t as readProcessMemory } from "../process-memory-DOEeg2pL.mjs";
+import { n as pickNodePlatformArch, t as readProcessMemory } from "../process-memory-C4v8DBKn.mjs";
 import * as os from "node:os";
 import * as fs from "node:fs";
 import * as path$1 from "node:path";
@@ -341,7 +341,7 @@ function normalizeEngineNodeId(rawNodeId) {
 //#endregion
 //#region src/detection-pipeline/model-bound-device-overrides.ts
 /**
-* Best settings (D745), the executor leg: list — and optionally remove — the
+* Auto tune (D745), the executor leg: list — and optionally remove — the
 * MODEL-BOUND thresholds stored in this addon's per-camera settings (the
 * object-detection root's `bindsToModel` keys and their binding keys, D738).
 * Every other key of a camera's store is kept.
@@ -8547,7 +8547,7 @@ var DetectionPipelineProvider = class DetectionPipelineProvider {
 	readDeviceStore;
 	/** Delete all per-device settings for a device (used by `clearDeviceOverrides`). */
 	clearDeviceStore;
-	/** Merge a patch into one device's settings (Best settings' keep-the-rest rewrite, D745). */
+	/** Merge a patch into one device's settings (Auto tune' keep-the-rest rewrite, D745). */
 	writeDeviceStore;
 	/**
 	* The per-device overrides the FRAME path reads, kept fresh off that path.
@@ -11148,7 +11148,7 @@ var DetectionPipelineProvider = class DetectionPipelineProvider {
 		};
 	}
 	/**
-	* Best settings (D745): list — or, unless `dryRun`, remove — the model-bound
+	* Auto tune (D745): list — or, unless `dryRun`, remove — the model-bound
 	* thresholds of the per-camera detector store. See
 	* `model-bound-device-overrides.ts`.
 	*/
@@ -11165,14 +11165,14 @@ var DetectionPipelineProvider = class DetectionPipelineProvider {
 			invalidate: (deviceId) => this.deviceOverrides.invalidate(deviceId),
 			boundKeys: collectModelBoundKeys(getStep("object-detection").getConfigSchema())
 		}, input);
-		if (!input.dryRun) for (const entry of result.entries) this.log.info("best settings: per-camera detector thresholds cleared", {
+		if (!input.dryRun) for (const entry of result.entries) this.log.info("auto tune: per-camera detector thresholds cleared", {
 			tags: { deviceId: entry.deviceId },
 			meta: {
 				deviceId: entry.deviceId,
 				keys: entry.keys
 			}
 		});
-		for (const r of result.refused) this.log.warn("best settings: per-camera detector thresholds not cleared", {
+		for (const r of result.refused) this.log.warn("auto tune: per-camera detector thresholds not cleared", {
 			tags: { deviceId: r.deviceId },
 			meta: {
 				deviceId: r.deviceId,

package/dist/{dist-CsA6fY6I.mjs → dist-B8oPeJDI.mjs}

@@ -26863,7 +26863,7 @@ var pipelineExecutorCapability = {
 			auth: "admin"
 		}),
 		/**
-		* 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
@@ -27235,7 +27235,143 @@ var pipelineExecutorCapability = {
 	}
 };
 /**
-* The wire shapes of the Best settings plan and apply (D745), used by the
+* Wire shapes of the Load balancing surface (D748): the session placement
+* policy, the atomic share write, the observed placement statistics, the
+* hardware share suggestion and the stale device pins.
+*/
+/**
+* How a new detection session picks its node and device.
+*  - `least-loaded` — the historical rule: lowest `attached / weight`, a
+*    constant node order at a tie (D37). An idle node always ties at 0, so a
+*    weight only bites once a node already holds a session.
+*  - `share` — the share of PARALLEL sessions is held to the weights, and a
+*    full or drowning node yields to a free one (D748).
+*/
+var SessionPlacementPolicySchema = _enum(["least-loaded", "share"]);
+var LoadBalancingSharesInputSchema = object({
+	/** nodeId → share (> 0). A node left out keeps its weight. */
+	nodes: record(string(), number().positive()).default({}),
+	/** nodeId → deviceKey → share (> 0). A device left out keeps its weight. */
+	devices: record(string(), record(string(), number().positive())).default({})
+});
+var PlacementStatsInputSchema = object({ 
+/** Window the observed shares are averaged over (default 1 h, max 24 h). */
+windowMs: number().int().min(6e4).max(1440 * 60 * 1e3).default(3600 * 1e3) });
+var PlacementDeviceStatsSchema = object({
+	deviceKey: string(),
+	/** Sessions running on this device now. */
+	sessionsNow: number(),
+	/** Sessions started on this device inside the window. */
+	sessionsStarted: number(),
+	/** Time-weighted share of the node's parallel sessions over the window (0–1); null = no session ran. */
+	observedShare: number().nullable()
+});
+var PlacementNodeStatsSchema = object({
+	nodeId: string(),
+	sessionsNow: number(),
+	sessionsStarted: number(),
+	/** Time-weighted share of the cluster's parallel sessions over the window (0–1); null = none ran. */
+	observedShare: number().nullable(),
+	/** Most sessions this node ran at once inside the window. */
+	peakSessions: number(),
+	/** Sessions a share election handed elsewhere because this node was full or drowning. */
+	yieldsAway: number(),
+	devices: array(PlacementDeviceStatsSchema).readonly()
+});
+/** A camera's device pin that the session path cannot honour. */
+var StaleDevicePinSchema = object({
+	deviceId: number(),
+	deviceKey: string(),
+	/** `disabled` — the key exists on some node but is not enabled anywhere; `absent` — no node has it. */
+	reason: _enum(["disabled", "absent"])
+});
+var PlacementStatsSchema = object({
+	policy: SessionPlacementPolicySchema,
+	windowMs: number(),
+	/** How much of the window was actually observed (the hub keeps it in memory). */
+	observedForMs: number(),
+	sessionsNow: number(),
+	/** Most parallel sessions across the cluster inside the window. */
+	clusterPeakSessions: number(),
+	nodes: array(PlacementNodeStatsSchema).readonly(),
+	stalePins: array(StaleDevicePinSchema).readonly()
+});
+var SuggestSharesInputSchema = object({ headroom: number().min(.3).max(.5).default(.4) });
+var SuggestedDeviceShareSchema = object({
+	deviceKey: string(),
+	/** Share of the node (0–100, rounded). */
+	share: number(),
+	modelId: string().nullable(),
+	/** Inferences per second at that model, from the measured table. */
+	fps: number().nullable(),
+	measured: boolean(),
+	/** Advisory session cap: ⌊fps × (1 − headroom) / camera fps⌋. Never enforced. */
+	suggestedMaxSessions: number().nullable()
+});
+var SuggestedNodeShareSchema = object({
+	nodeId: string(),
+	/** Share of the cluster (0–100, rounded); null = node skipped (offline, unknown hardware). */
+	share: number().nullable(),
+	/** Parallel sessions the node sustains at the suggested models with the headroom kept free. */
+	capacitySessions: number(),
+	devices: array(SuggestedDeviceShareSchema).readonly(),
+	skippedReason: string().nullable()
+});
+var SuggestSharesResultSchema = object({
+	headroom: number(),
+	/** Camera detection rate the capacity is counted in (the fastest camera's fps). */
+	cameraFps: number(),
+	/** How many share → model → capacity rounds ran before the shares stopped moving (≤ 3). */
+	iterations: number(),
+	nodes: array(SuggestedNodeShareSchema).readonly()
+});
+/**
+* Where the node and device shares come from (D750).
+*  - `auto` — computed by the system from the cluster's measured capacity at
+*    the Auto tune models, and recomputed whenever a node or device joins,
+*    leaves, is switched on or off, or changes model.
+*  - `manual` — the operator's stored sliders. A node or device that cannot
+*    take sessions gives its share to the others in proportion; the stored
+*    values are never rewritten for that.
+*/
+var ShareSourceSchema = _enum(["auto", "manual"]);
+var SetShareSourceInputSchema = object({ source: ShareSourceSchema });
+object({
+	nodes: record(string(), number()),
+	devices: record(string(), record(string(), number()))
+});
+var EffectiveDeviceShareSchema = object({
+	deviceKey: string(),
+	/** Can take sessions now (enabled, available, can run the root). */
+	eligible: boolean(),
+	/** The share the source assigns, as a percentage of the node's devices. */
+	configuredPct: number(),
+	/** The share actually used, after an ineligible device's share went to the others. */
+	effectivePct: number()
+});
+var EffectiveNodeShareSchema = object({
+	nodeId: string(),
+	eligible: boolean(),
+	configuredPct: number(),
+	effectivePct: number(),
+	devices: array(EffectiveDeviceShareSchema).readonly()
+});
+var EffectiveSharesSchema = object({
+	source: ShareSourceSchema,
+	policy: SessionPlacementPolicySchema,
+	/** `auto` with no computed answer yet: the stored sliders are used meanwhile. */
+	autoPending: boolean(),
+	/** When the automatic shares were last computed (ms epoch); null = never. */
+	computedAt: number().nullable(),
+	/** What made the system recompute them last. */
+	trigger: string().nullable(),
+	nodes: array(EffectiveNodeShareSchema).readonly(),
+	/** The relative weights the election reads (before eligibility). */
+	nodeWeights: record(string(), number()),
+	deviceWeights: record(string(), record(string(), number()))
+});
+/**
+* The wire shapes of the Auto tune plan and apply (D745), used by the
 * `pipeline-orchestrator` cap. The recommender's own types
 * (`recommend.ts`, `demand.ts`) are the TS face of the same data; these
 * schemas are what crosses the cap boundary.
@@ -27311,7 +27447,9 @@ var DeviceDemandSchema = object({
 		"estimate",
 		"none"
 	]),
-	observedForMs: number().nullable()
+	observedForMs: number().nullable(),
+	/** How on-motion sessions were charged: per-device observation, or split by share (D748). */
+	placement: SessionPlacementPolicySchema
 });
 var DeviceModelChoiceSchema = object({
 	modelId: string(),
@@ -27368,7 +27506,7 @@ var DetectorStoreClearSchema = object({
 	deviceId: number(),
 	keys: array(string()).readonly()
 });
-var BestSettingsWarningSchema = discriminatedUnion("kind", [
+var AutoTuneWarningSchema = discriminatedUnion("kind", [
 	object({
 		kind: literal("detector-store-cluster-wide"),
 		skippedNodes: array(string()).readonly()
@@ -27383,26 +27521,36 @@ var BestSettingsWarningSchema = discriminatedUnion("kind", [
 		deviceKey: string()
 	})
 ]);
-var BestSettingsOptionsSchema = object({ 
-/** Share of each accelerator's throughput kept free (0.3–0.5). */
-headroom: number().min(.3).max(.5).default(.4) });
-var BestSettingsPlanSchema = object({
+var AutoTuneOptionsSchema = object({
+	/** Share of each accelerator's throughput kept free (0.3–0.5). */
+	headroom: number().min(.3).max(.5).default(.4),
+	/**
+	* What-if shares (D748): plan as if these node/device shares were stored
+	* and the policy were `share`. Absent = the stored shares under the stored
+	* policy. A what-if plan is for display; apply always re-plans from what
+	* is stored.
+	*/
+	shares: LoadBalancingSharesInputSchema.optional()
+});
+var AutoTunePlanSchema = object({
 	/** Hash of everything the apply will write — the apply refuses a different one. */
 	planHash: string(),
 	family: literal("yolov9"),
 	headroom: number(),
+	/** Planned under what-if shares (D748): for display — apply refuses it as stale. */
+	whatIf: boolean(),
 	generatedAt: number(),
 	nodes: array(NodeRecommendationSchema).readonly(),
 	nodeChanges: array(NodeDeviceChangeSchema).readonly(),
 	cameraClears: array(CameraOverrideClearSchema).readonly(),
 	detectorStoreClears: array(DetectorStoreClearSchema).readonly(),
-	warnings: array(BestSettingsWarningSchema).readonly()
+	warnings: array(AutoTuneWarningSchema).readonly()
 });
-var BestSettingsApplyInputSchema = object({
+var AutoTuneApplyInputSchema = object({
 	planHash: string(),
 	headroom: number().min(.3).max(.5).default(.4)
 });
-var BestSettingsPhaseResultSchema = object({
+var AutoTunePhaseResultSchema = object({
 	phase: _enum([
 		"download",
 		"camera-overrides",
@@ -27413,19 +27561,19 @@ var BestSettingsPhaseResultSchema = object({
 	ok: boolean(),
 	detail: string()
 });
-var BestSettingsApplyResultSchema = discriminatedUnion("kind", [
+var AutoTuneApplyResultSchema = discriminatedUnion("kind", [
 	object({
 		kind: literal("applied"),
 		planHash: string(),
-		phases: array(BestSettingsPhaseResultSchema).readonly()
+		phases: array(AutoTunePhaseResultSchema).readonly()
 	}),
 	object({
 		kind: literal("aborted"),
-		phases: array(BestSettingsPhaseResultSchema).readonly()
+		phases: array(AutoTunePhaseResultSchema).readonly()
 	}),
 	object({
 		kind: literal("stale"),
-		plan: BestSettingsPlanSchema
+		plan: AutoTunePlanSchema
 	}),
 	object({
 		kind: literal("refused"),
@@ -28804,7 +28952,6 @@ var CameraStepOverridePatchSchema = object({
 	settings: record(string(), unknown()).readonly().optional()
 });
 var CameraPipelineSettingsSchema = object({
-	pinnedAgentNodeId: string().optional(),
 	stepToggles: record(string(), boolean()).optional(),
 	stepOverridesByDevice: record(string(), record(string(), record(string(), CameraStepOverridePatchSchema))).optional(),
 	pipelineByAgent: record(string(), CameraPipelineForAgentSchema).optional()
@@ -29303,12 +29450,6 @@ method(object({
 }), object({ success: literal(true) }), {
 	kind: "mutation",
 	auth: "admin"
-}), method(object({
-	agentNodeId: string(),
-	detectWeight: number().positive().nullable()
-}), object({ success: literal(true) }), {
-	kind: "mutation",
-	auth: "admin"
 }), method(object({
 	agentNodeId: string(),
 	detect: boolean().nullable().optional(),
@@ -29350,7 +29491,13 @@ method(object({
 }), {
 	kind: "mutation",
 	auth: "admin"
-}), method(BestSettingsOptionsSchema, BestSettingsPlanSchema, { auth: "admin" }), method(BestSettingsApplyInputSchema, BestSettingsApplyResultSchema, {
+}), method(AutoTuneOptionsSchema, AutoTunePlanSchema, { auth: "admin" }), method(AutoTuneApplyInputSchema, AutoTuneApplyResultSchema, {
+	kind: "mutation",
+	auth: "admin"
+}), method(LoadBalancingSharesInputSchema, object({ success: literal(true) }), {
+	kind: "mutation",
+	auth: "admin"
+}), method(PlacementStatsInputSchema, PlacementStatsSchema, { auth: "admin" }), method(SuggestSharesInputSchema, SuggestSharesResultSchema, { auth: "admin" }), method(_void(), EffectiveSharesSchema, { auth: "admin" }), method(SetShareSourceInputSchema, object({ success: literal(true) }), {
 	kind: "mutation",
 	auth: "admin"
 }), method(object({ deviceId: number() }), CameraPipelineSettingsSchema.nullable()), method(object({
@@ -46186,7 +46333,7 @@ Object.freeze({
 		addonId: null,
 		access: "view"
 	},
-	"pipelineOrchestrator.applyBestSettings": {
+	"pipelineOrchestrator.applyAutoTune": {
 		capName: "pipeline-orchestrator",
 		capScope: "system",
 		addonId: null,
@@ -46306,6 +46453,12 @@ Object.freeze({
 		addonId: null,
 		access: "view"
 	},
+	"pipelineOrchestrator.getEffectiveShares": {
+		capName: "pipeline-orchestrator",
+		capScope: "system",
+		addonId: null,
+		access: "view"
+	},
 	"pipelineOrchestrator.getGlobalMetrics": {
 		capName: "pipeline-orchestrator",
 		capScope: "system",
@@ -46342,6 +46495,12 @@ Object.freeze({
 		addonId: null,
 		access: "view"
 	},
+	"pipelineOrchestrator.getPlacementStats": {
+		capName: "pipeline-orchestrator",
+		capScope: "system",
+		addonId: null,
+		access: "view"
+	},
 	"pipelineOrchestrator.getReconcileFromDiskStatus": {
 		capName: "pipeline-orchestrator",
 		capScope: "system",
@@ -46366,7 +46525,7 @@ Object.freeze({
 		addonId: null,
 		access: "create"
 	},
-	"pipelineOrchestrator.planBestSettings": {
+	"pipelineOrchestrator.planAutoTune": {
 		capName: "pipeline-orchestrator",
 		capScope: "system",
 		addonId: null,
@@ -46432,12 +46591,6 @@ Object.freeze({
 		addonId: null,
 		access: "create"
 	},
-	"pipelineOrchestrator.setAgentDetectWeight": {
-		capName: "pipeline-orchestrator",
-		capScope: "system",
-		addonId: null,
-		access: "create"
-	},
 	"pipelineOrchestrator.setAgentInferenceDevices": {
 		capName: "pipeline-orchestrator",
 		capScope: "system",
@@ -46492,12 +46645,30 @@ Object.freeze({
 		addonId: null,
 		access: "create"
 	},
+	"pipelineOrchestrator.setLoadBalancingShares": {
+		capName: "pipeline-orchestrator",
+		capScope: "system",
+		addonId: null,
+		access: "create"
+	},
 	"pipelineOrchestrator.setPipelineDevicePin": {
 		capName: "pipeline-orchestrator",
 		capScope: "system",
 		addonId: null,
 		access: "create"
 	},
+	"pipelineOrchestrator.setShareSource": {
+		capName: "pipeline-orchestrator",
+		capScope: "system",
+		addonId: null,
+		access: "create"
+	},
+	"pipelineOrchestrator.suggestShares": {
+		capName: "pipeline-orchestrator",
+		capScope: "system",
+		addonId: null,
+		access: "view"
+	},
 	"pipelineOrchestrator.unassignAudio": {
 		capName: "pipeline-orchestrator",
 		capScope: "system",
@@ -53767,7 +53938,7 @@ function applyModelBoundSettings(settings, boundKeys, runningModelId) {
 /**
 * The keys of every `bindsToModel` field of a step's config schema, groups
 * flattened (D738). One definition for the runner (which applies the binding)
-* and the orchestrator's Best settings (which clears those overrides, D745).
+* and the orchestrator's Auto tune (which clears those overrides, D745).
 */
 function collectModelBoundKeys(fields) {
 	return fields.flatMap((field) => {