@camstack/types 1.2.178 → 1.2.180

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: 1027 method paths across 129 capabilities.
+ * Coverage: 1029 method paths across 129 capabilities.
  */
 import type { CapabilityMethodAccess } from '../capabilities/capability-definition.js';
 export interface MethodAccessRecord {

package/dist/generated/method-device-selectors.d.ts

@@ -6,8 +6,8 @@
  * system-scope cap that takes a deviceId was previously never device-filtered
  * — see the generator header).
  *
- * Coverage: 372 methods carry a device reference, of which
- * 137 are on SYSTEM-scope caps.
+ * Coverage: 374 methods carry a device reference, of which
+ * 139 are on SYSTEM-scope caps.
  *
  * Top-level fields, number arrays, and one-level arrays of objects carrying
  * a numeric device field (targets[].deviceId) are all mapped; the matcher

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

@@ -59,7 +59,7 @@ export interface SystemProxy {
     readonly addonSettings: Pick<InferProvider<typeof addonSettingsCapability>, 'getGlobalSettings' | 'updateGlobalSettings' | 'getIntegrationSettings'>;
     readonly addonWidgets: Pick<InferProvider<typeof addonWidgetsCapability>, 'listWidgets'>;
     readonly alerts: Pick<InferProvider<typeof alertsCapability>, 'emit' | 'update' | 'list' | 'getUnreadCount' | 'markRead' | 'markAllRead' | 'dismiss'>;
-    readonly audioAnalyzer: Pick<InferProvider<typeof audioAnalyzerCapability>, 'analyseChunk' | 'classify' | 'isReady' | 'dispose' | 'reprobeAudioEngine'>;
+    readonly audioAnalyzer: Pick<InferProvider<typeof audioAnalyzerCapability>, 'analyseChunk' | 'classify' | 'attachDevice' | 'isReady' | 'dispose' | 'reprobeAudioEngine'>;
     readonly audioCodec: Pick<InferProvider<typeof audioCodecCapability>, 'listSupportedCodecs' | 'canHandle' | 'createDecodeSession' | 'createEncodeSession' | 'closeSession' | 'pushEncodedFrame' | 'pullPcm' | 'pushPcm' | 'pullEncoded' | 'flushEncode' | 'listActiveSessions'>;
     readonly backup: Pick<InferProvider<typeof backupCapability>, 'listDestinations' | 'trigger' | 'listRuns' | 'cancel' | 'list' | 'listLocations' | 'getEntries' | 'restore' | 'delete' | 'listArchives' | 'upsertDestinationPolicy' | 'previewSchedule' | 'listSchedules' | 'upsertSchedule' | 'deleteSchedule'>;
     readonly broker: Pick<InferProvider<typeof brokerCapability>, 'list' | 'get' | 'listProviders' | 'add' | 'remove' | 'testConnection' | 'getSettings' | 'setSettings' | 'getBrokerConfig' | 'getSettingsSchema' | 'testSettings' | 'publish' | 'subscribe' | 'unsubscribe' | 'getState' | 'getStatus'>;

package/dist/index.d.ts

@@ -1,3 +1,4 @@
+export * from './audio/audio-chunk-format.js';
 export type { CapabilitiesAccess } from './addon/base-addon.js';
 export { BaseAddon, normalizeAddonInitResult } from './addon/base-addon.js';
 export type { AddonRouteInvokeRequest, AddonRouteReplyEnvelope, } from './addon/build-addon-route-provider.js';
@@ -28,7 +29,7 @@ export type * from './interfaces/analysis.js';
 export * from './interfaces/analysis-persistence.js';
 export type * from './interfaces/api-responses.js';
 export type * from './interfaces/api-shared.js';
-export type { AudioClassificationResult, IAudioAnalyzer } from './interfaces/audio-analyzer.js';
+export type { AudioAttachDeviceInput, AudioAttachDeviceResult, AudioClassificationResult, AudioDetachDeviceResult, IAudioAnalyzer, } from './interfaces/audio-analyzer.js';
 export type * from './interfaces/audio-inference-engine.js';
 export type * from './interfaces/auth.js';
 export type * from './interfaces/camera-pipeline.js';
@@ -209,6 +210,7 @@ export type { AudioCodecInfo, AudioDecodeSessionConfig, AudioEncodedChunk, Audio
 export type { StreamQuality } from './interfaces/device-capabilities/camera.js';
 export { STREAM_QUALITY_LABELS, streamQualityLabel, } from './interfaces/device-capabilities/camera.js';
 export * from './lifecycle/index.js';
+export { AUDIO_SCALE_EPOCH_ISO, AUDIO_SCALE_EPOCH_MS, type AudioScaleEra, audioScaleEraOf, G711_SCALE_CORRECTION_DB, type G711Law, ituDbfsFromPreEpoch, } from './audio/audio-scale-epoch.js';
 export { audioIsFailClosed, audioKindId, audioLabelChoices, audioModeOf, audioOrDefaults, isAudioLabelSelected, NC_AUDIO_CONFIRM_HITS_DEFAULT, NC_AUDIO_CONFIRM_HITS_MAX, NC_AUDIO_CONFIRM_HITS_MIN, NC_AUDIO_CONFIRM_WINDOW_MAX_SEC, NC_AUDIO_CONFIRM_WINDOW_MIN_SEC, NC_AUDIO_CONFIRM_WINDOW_SEC_DEFAULT, NC_AUDIO_DB_MAX, NC_AUDIO_DB_MIN, NC_AUDIO_DB_OFFERED, NC_AUDIO_DB_STEP, NC_AUDIO_DEFAULTS, NC_AUDIO_HIT_PERCENT_MAX, NC_AUDIO_HIT_PERCENT_MIN, NC_AUDIO_SAMPLING_MAX_SEC, NC_AUDIO_SAMPLING_MIN_SEC, type NcAudioLabelChoice, type NcAudioMode, type NcAudioPatch, normalizeAudioLabel, patchAudio, toggleAudioLabel, } from './notification/audio-condition.js';
 export { isBaseConditionKey, knownValues, NC_BASE_CONDITION_KEYS, type NcBaseConditionKey, pickerForCondition, type TaxonomyGroup, type TaxonomyOption, type TaxonomyPicker, } from './notification/condition-taxonomy.js';
 export { type PreparedAction, type PreparedAttachment, type PreparedNotification, prepareNotification, type ResolvedLevel, } from './notification/degrade-engine.js';

package/dist/index.js

@@ -1,6 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_sleep = require("./sleep-B1ZwxAhh.js");
 const require_event_category = require("./event-category-BNJ9EE5B.js");
-const require_sleep = require("./sleep-CTHjJilA.js");
 const require_canonical_hash = require("./canonical-hash-DNV8S5ET.js");
 const require_enums = require("./enums.js");
 const require_err_msg = require("./err-msg-COpsHMw2.js");
@@ -1954,6 +1954,30 @@ var noDuplicates = (values) => new Set(values).size === values.length;
 * sensori su UNA camera è già oltre qualunque installazione osservata.
 */
 var MAX_SENSOR_TRIGGER_DEVICES = 16;
+/**
+* What the bands editor OFFERS when an operator first ticks "audio above
+* threshold" on a band. Not a schema default: an absent `audioThresholdDbfs`
+* means the audio source is not listened to at all, and it stays absent until
+* asked for.
+*
+* It lived as a bare `-30` inline in `RecordingBandsEditor.tsx`, which is how
+* a calibration hides: unnamed, unexplained, and invisible to any guard. D460
+* gave it a name so the claim below can be read and disagreed with.
+*
+* **Not shifted at the D459 epoch.** `-30 dBFS is loud enough to be worth
+* recording` is a statement about the scale, not a number anybody read off the
+* pre-epoch decoder — there is no recorded measurement behind it, and absent
+* evidence of measurement the provenance test says a scale statement stays put
+* (the reasoning is D460's, and the same answer `SILENCE_FLOOR_DBFS` gets).
+*
+* As with `audioMarkerMinDbfs`, the epoch makes this seed START working rather
+* than become too permissive: on the old scale a PCMU camera had to reach a
+* true -18 dBFS to read -30, so the trigger was nearly dead on 19 of 25
+* cameras. A band seeded with it now fires roughly as the editor implies.
+*
+* @dbfs-era itu
+*/
+var RECORDING_AUDIO_TRIGGER_OFFERED_DBFS = -30;
 /** Which detectors trigger an `events`-mode band. */
 var RecordingTriggersSchema = zod.z.object({
 	motion: zod.z.boolean().optional(),
@@ -6993,6 +7017,51 @@ var AudioAnalysisSettingsSchema = zod.z.object({
 	minConfidence: zod.z.number().min(0).max(1).default(.3),
 	allowedClasses: zod.z.array(zod.z.string()).default([])
 });
+/**
+* `attachDevice` — the analyzer PULLS a camera's audio from the broker (D461).
+*
+* Until D461 the orchestrator drained the broker's chunk plane, accumulated
+* ~1 s windows and pushed them back out as `analyseChunk`. It neither produced
+* nor consumed the audio: the PCM crossed hub-main twice for a process that
+* only buffered it. `attachDevice` inverts the direction — the analyzer opens
+* its own `subscribeAudioChunks` against the broker and the subscriber IS the
+* decoder, so the coded G.711 bytes D455 put on the plane stay coded all the
+* way to the one expansion that feeds the model.
+*
+* The orchestrator still owns the POLICY (the `audioMode` gate, the on-motion
+* window, the per-device node assignment, the settings read) and therefore
+* still owns the attach/detach pair. It no longer owns the bytes.
+*/
+var AudioAttachDeviceInputSchema = zod.z.object({
+	deviceId: zod.z.number(),
+	/** Broker id (`<deviceId>/<camStreamId>`) carrying this camera's audio. */
+	brokerId: zod.z.string(),
+	/**
+	* `clusterRoles.ingestNode` — the node whose broker owns the source dial.
+	* Every `streamBroker` call the attachment makes is pinned to it, exactly as
+	* the orchestrator's poller pinned them before the move.
+	*/
+	ingestNodeId: zod.z.string(),
+	/**
+	* Resolved once by the orchestrator at attach time, exactly as it was read
+	* once per subscription before D461. The analyzer does NOT re-resolve per
+	* window: a settings change re-attaches, which is what always happened.
+	*/
+	settings: AudioAnalysisSettingsSchema
+});
+var AudioAttachDeviceResultSchema = zod.z.object({
+	/** False only when the analyzer is shutting down and refused to attach. */
+	attached: zod.z.boolean(),
+	/**
+	* True when the attachment replaced a live one for the same device. An
+	* attach is idempotent by REPLACEMENT — two pollers on one camera would
+	* double the broker's fanout and neither would know about the other.
+	*/
+	replaced: zod.z.boolean()
+});
+var AudioDetachDeviceResultSchema = zod.z.object({ 
+/** False when no attachment existed — detach is idempotent. */
+detached: zod.z.boolean() });
 var AudioClassificationResultSchema = zod.z.object({
 	labels: zod.z.array(AudioClassificationLabelSchema).readonly(),
 	rawLabels: zod.z.array(AudioClassificationLabelSchema).readonly().optional(),
@@ -7041,6 +7110,21 @@ var audioAnalyzerCapability = {
 			settings: AudioAnalysisSettingsSchema
 		}), AudioAnalysisResultSchema.nullable(), { kind: "mutation" }),
 		classify: require_sleep.method(AudioChunkInputSchema, AudioClassificationResultSchema, { timeoutMs: 3e4 }),
+		/**
+		* Start pulling this camera's audio from the broker, in THIS process.
+		* Returns as soon as the attachment exists — the first
+		* `subscribeAudioChunks` retries with backoff behind it, because the
+		* broker for a camStream may not be registered yet (that tolerance moved
+		* with the poller, D461). Replaces any live attachment for the device.
+		*/
+		attachDevice: require_sleep.method(AudioAttachDeviceInputSchema, AudioAttachDeviceResultSchema, { kind: "mutation" }),
+		/**
+		* Stop pulling this camera's audio and release the broker subscription.
+		* Idempotent. A detach that never arrives is the one failure mode this
+		* split adds, which is why `AudioChunkPlane` reaps a subscription nobody
+		* drains rather than trusting it (D461).
+		*/
+		detachDevice: require_sleep.method(zod.z.object({ deviceId: zod.z.number() }), AudioDetachDeviceResultSchema, { kind: "mutation" }),
 		isReady: require_sleep.method(zod.z.void(), zod.z.boolean()),
 		dispose: require_sleep.method(zod.z.void(), zod.z.void(), { kind: "mutation" }),
 		/**
@@ -15751,6 +15835,12 @@ var NcOccupancyConditionSchema = zod.z.object({
 * number. An operator (or a UI) that writes `60` meaning "60 decibels, quite
 * loud" would author a threshold NO sample can ever reach, and the rule would
 * look broken rather than mis-configured. The schema range rejects it instead.
+*
+* Untouched by the D459 scale correction, and structurally so: -96 dBFS is
+* where 16-bit digital silence sits on ANY decoder, right or wrong. It
+* describes the container, not a calibration made through one.
+*
+* @dbfs-era scale-bound
 */
 var NC_AUDIO_DBFS_FLOOR = -96;
 /**
@@ -21181,6 +21271,14 @@ var NativeCropResultSchema = zod.z.object({
 	* set `encodeJpeg: true`; `bytes` is then absent.
 	*/
 	jpeg: zod.z.string().optional(),
+	/**
+	* The SAME compressed JPEG as `jpeg`, as bytes (D462). Present instead of
+	* `jpeg` when the request set `acceptJpegBytes`; a request that did not gets
+	* `jpeg` exactly as before. MsgPack and the mesh leg both carry binary —
+	* `bytes` above has crossed this boundary as a `Uint8Array` all along — so
+	* base64 was buying nothing but a multi-megabyte string in the relay's heap.
+	*/
+	jpegBytes: zod.z.instanceof(Uint8Array).optional(),
 	width: zod.z.number().int().positive(),
 	height: zod.z.number().int().positive(),
 	/**
@@ -21247,7 +21345,14 @@ var ParkTrackFrameResultSchema = zod.z.discriminatedUnion("parked", [zod.z.objec
 })]);
 /** A retrieved parcel — the runner's own JPEG, base64 for the wire. */
 var ParkedTrackFrameSchema = zod.z.object({
-	jpeg: zod.z.string(),
+	/**
+	* Base64 JPEG — the pre-D462 wire. OPTIONAL since D462: a request that set
+	* `acceptJpegBytes` is answered in `jpegBytes` and this is then absent.
+	* Exactly one of the two is present.
+	*/
+	jpeg: zod.z.string().optional(),
+	/** The same JPEG as bytes, for a caller that declared it reads them (D462). */
+	jpegBytes: zod.z.instanceof(Uint8Array).optional(),
 	width: zod.z.number().int().positive(),
 	height: zod.z.number().int().positive(),
 	/** The frame instant the parcel shows (the caller's clock, echoed back). */
@@ -22086,6 +22191,13 @@ var pipelineRunnerCapability = {
 			bbox: NativeCropBboxSchema,
 			maxWidth: zod.z.number().int().positive().optional(),
 			/**
+			* The caller reads a `Uint8Array` (D462). When set, a JPEG answer comes
+			* back in `jpegBytes` instead of base64 `jpeg`. Absent means the old
+			* wire — never assume consent: a pre-D462 caller parses the field as
+			* base64 and bytes would decode to garbage rather than fail.
+			*/
+			acceptJpegBytes: zod.z.boolean().optional(),
+			/**
 			* When `true`, the runner encodes the resolved crop to JPEG ON THE
 			* OWNING NODE and returns it in `jpeg` (base64) INSTEAD of raw `bytes`.
 			* Callers set this for CROSS-NODE fetches (`handle.nodeId` is a remote
@@ -22258,7 +22370,14 @@ var pipelineRunnerCapability = {
 		getParkedTrackFrame: require_sleep.method(zod.z.object({
 			deviceId: zod.z.number(),
 			trackId: zod.z.string(),
-			kind: ParkedFrameKindSchema
+			kind: ParkedFrameKindSchema,
+			/**
+			* The caller reads a `Uint8Array` (D462). When set, a JPEG answer comes
+			* back in `jpegBytes` instead of base64 `jpeg`. Absent means the old
+			* wire — never assume consent: a pre-D462 caller parses the field as
+			* base64 and bytes would decode to garbage rather than fail.
+			*/
+			acceptJpegBytes: zod.z.boolean().optional()
 		}), ParkedTrackFrameSchema.nullable()),
 		/**
 		* Drop every parcel of a track — the hub closed it. Idempotent. A track
@@ -42285,12 +42404,24 @@ var METHOD_ACCESS_MAP = Object.freeze({
 		addonId: null,
 		access: "create"
 	},
+	"audioAnalyzer.attachDevice": {
+		capName: "audio-analyzer",
+		capScope: "system",
+		addonId: null,
+		access: "create"
+	},
 	"audioAnalyzer.classify": {
 		capName: "audio-analyzer",
 		capScope: "system",
 		addonId: null,
 		access: "view"
 	},
+	"audioAnalyzer.detachDevice": {
+		capName: "audio-analyzer",
+		capScope: "system",
+		addonId: null,
+		access: "create"
+	},
 	"audioAnalyzer.dispose": {
 		capName: "audio-analyzer",
 		capScope: "system",
@@ -48403,11 +48534,21 @@ var METHOD_DEVICE_SELECTORS = Object.freeze({
 		form: "single",
 		optional: false
 	}],
+	"audioAnalyzer.attachDevice": [{
+		name: "deviceId",
+		form: "single",
+		optional: false
+	}],
 	"audioAnalyzer.classify": [{
 		name: "deviceId",
 		form: "single",
 		optional: true
 	}],
+	"audioAnalyzer.detachDevice": [{
+		name: "deviceId",
+		form: "single",
+		optional: false
+	}],
 	"audioMetrics.getCurrentSnapshot": [{
 		name: "deviceId",
 		form: "single",
@@ -50255,7 +50396,9 @@ var METHOD_DEVICE_SELECTORS = Object.freeze({
 var SYSTEM_SCOPE_DEVICE_METHODS = [
 	"addonSettings.getDeviceSettings",
 	"addonSettings.updateDeviceSettings",
+	"audioAnalyzer.attachDevice",
 	"audioAnalyzer.classify",
+	"audioAnalyzer.detachDevice",
 	"decoder.createSession",
 	"deviceAdoption.release",
 	"deviceAdoption.resync",
@@ -50917,6 +51060,7 @@ function createSystemProxy(api) {
 		audioAnalyzer: {
 			analyseChunk: (input) => dispatch("audioAnalyzer", "analyseChunk", "mutation", input),
 			classify: (input) => dispatch("audioAnalyzer", "classify", "query", input),
+			attachDevice: (input) => dispatch("audioAnalyzer", "attachDevice", "mutation", input),
 			isReady: (input) => dispatch("audioAnalyzer", "isReady", "query", input),
 			dispose: (input) => dispatch("audioAnalyzer", "dispose", "mutation", input),
 			reprobeAudioEngine: (input) => dispatch("audioAnalyzer", "reprobeAudioEngine", "mutation", input)
@@ -51490,6 +51634,112 @@ function createSystemProxy(api) {
 	};
 }
 //#endregion
+//#region src/audio/audio-scale-epoch.ts
+/**
+* The instant the audio amplitude scale changed, and by how much (D459).
+*
+* ## What happened
+*
+* Until this epoch the native RTP G.711 decoder that feeds the audio chunk
+* plane — `stream-broker/rtsp/audio-rtp-decoder.ts`, the PCM the audio
+* CLASSIFIER and the dBFS level meter read — decoded μ-law at exactly 1/4 of
+* its ITU-T G.711 value and A-law at exactly −1/8 (magnitude *and* sign). The
+* WebRTC/Opus egress decoded the same bytes correctly in `g711-mulaw.ts`, so
+* **the audio an operator HEARD was right and the audio the detector MEASURED
+* was 4–8× quieter**, which is why it survived so long.
+*
+* Non-G.711 sources — AAC and Opus, decoded through the `audio-codec` cap —
+* were always on the ITU-T scale and are NOT affected. Nothing here should
+* ever be applied to them.
+*
+* ## What this module is for, and what it is NOT for
+*
+* It is the ONE place the two numbers live, so no caller re-derives them and
+* no second constant can disagree. It exists for two readers:
+*
+*  - **A person re-calibrating a threshold.** Every absolute-dBFS gate
+*    authored before the epoch against a native G.711 camera is now that many
+*    dB too permissive: `NcAudioCondition.dbThreshold`,
+*    `RecordingTriggers.audioThresholdDbfs`, `audioMarkerMinDbfs`, and the
+*    viewer's per-grid `audioDb`.
+*  - **Anything drawing a level across the epoch.** A graph that spans it
+*    shows a step of 12.04 dB (PCMU) or 18.06 dB (PCMA) on the affected
+*    cameras. `audioScaleEraOf` is how a reader says which side a sample is
+*    on instead of leaving the step unexplained.
+*
+* **It is NOT a gain to apply to a sample.** Stored history is NOT rewritten
+* and live audio is NOT re-scaled: the decoder is correct now, and a second
+* authority that "fixes up" a number the decoder already got right is the
+* defect again with an extra place to argue with. Nor can history be
+* retro-corrected honestly — `DecodedAudioChunk` never carried the codec, so
+* a stored `AudioEvent.dbfs` does not say which of the two factors (or
+* neither) applied to it. Guessing per row is exactly the move that wrote the
+* original defect.
+*/
+/** Spelling of the epoch, so the millisecond constant is readable. */
+var AUDIO_SCALE_EPOCH_ISO = "2026-09-11T00:00:00.000Z";
+/**
+* The instant, in epoch milliseconds. A reading at or after it is on the
+* ITU-T scale; a reading before it, from a native G.711 camera, is 12–18 dB
+* low.
+*
+* It is the DAY, not the deploy minute, and deliberately so: the correction
+* reaches each node when that node's `addon-pipeline` is redeployed, which is
+* neither simultaneous across the fleet nor knowable from here. A reader that
+* treats the boundary as fuzzy by a few hours is reading it correctly; one
+* that treats a sample 200 ms after it as authoritative is not.
+*/
+var AUDIO_SCALE_EPOCH_MS = Date.parse(AUDIO_SCALE_EPOCH_ISO);
+var G711_SCALE_CORRECTION_DB = {
+	PCMU: 20 * Math.log10(4),
+	PCMA: 20 * Math.log10(8)
+};
+/**
+* Restate a dBFS number that was MEASURED through the pre-epoch decoder as the
+* same intent on the ITU-T scale (D460).
+*
+* ## When this applies, and when it is the wrong thing to reach for
+*
+* An absolute-dBFS number in this repo is one of two things, and only one of
+* them converts:
+*
+*  - **A statement about the scale** — "-55 dBFS is near silence", "-25 dBFS
+*    is loud". It was true on the ITU-T scale before the epoch and it is true
+*    after. The defect was never in the number; it was that 19 of this hub's
+*    25 cameras did not obey it. Converting such a number takes something
+*    correct and makes it wrong, in order to preserve a bug.
+*  - **A measurement taken through the old decoder** — a value someone read
+*    off a meter that under-reported by exactly 4× (PCMU) or 8× (PCMA). It
+*    describes a sound that was really {@link G711_SCALE_CORRECTION_DB} dB
+*    louder. That is what this function is for.
+*
+* Telling the two apart is a question about PROVENANCE, not about arithmetic,
+* and it cannot be answered from the number. It is answered by the comment the
+* author left — which is why `scripts/check-dbfs-era.mts` makes leaving one
+* mandatory.
+*
+* ## Why a function and not a typed-in number
+*
+* `-55 + 12.04` written into a source file is, six months later, completely
+* indistinguishable from a threshold somebody simply preferred. Calling this
+* keeps the derivation, the law, and the original measurement all visible at
+* the call site, so a future reader can disagree with the *premise* instead of
+* having to reverse-engineer the sum.
+*
+* **This is not a runtime gain.** It converts an authored CONSTANT once, where
+* it is declared. It must never be applied to a live sample or a stored
+* `AudioEvent.dbfs`: the decoder is correct now, and a second authority
+* adjusting numbers the decoder already got right is the original defect with
+* an extra place to argue with (D459).
+*/
+function ituDbfsFromPreEpoch(law, authoredDbfs) {
+	return authoredDbfs + G711_SCALE_CORRECTION_DB[law];
+}
+function audioScaleEraOf(timestampMs) {
+	if (!Number.isFinite(timestampMs) || timestampMs <= 0) return "unknown";
+	return timestampMs >= AUDIO_SCALE_EPOCH_MS ? "itu" : "pre-itu";
+}
+//#endregion
 //#region src/notification/audio-condition.ts
 /**
 * audio-condition — the authoring logic behind the sustained-sound condition
@@ -51547,8 +51797,21 @@ function audioKindId(macroId) {
 }
 /** Level bounds, in dBFS. Negative-going: the ceiling is full scale. */
 var NC_AUDIO_DB_MIN = -96;
+/**
+* Full scale. The ceiling of dBFS itself on any decoder, not a calibration —
+* untouched by D459 and untouchable by anything like it.
+*
+* @dbfs-era scale-bound
+*/
 var NC_AUDIO_DB_MAX = 0;
-/** Step of the level control — 3 dB is one perceptual notch, not one unit. */
+/**
+* Step of the level control — 3 dB is one perceptual notch, not one unit.
+*
+* A step between two levels, so it survives any uniform scale change: 3 dB is
+* the same interval before and after the D459 epoch.
+*
+* @dbfs-era relative
+*/
 var NC_AUDIO_DB_STEP = 3;
 /**
 * Offered when the operator turns the level filter ON. NOT a schema default:
@@ -51563,8 +51826,42 @@ var NC_AUDIO_DB_STEP = 3;
 * operator turned the filter on for, and the rule looks broken rather than
 * mis-seeded. The offered floor is the QUIET end of that measured band; the
 * editor says which way the number runs rather than leaving it to be inferred.
-*/
-var NC_AUDIO_DB_OFFERED = -55;
+*
+* ⚠ **That measurement was taken on the pre-D459 scale, and D460 moved this
+* constant because of it.** Until {@link AUDIO_SCALE_EPOCH_MS} the native RTP
+* G.711 decoder reported levels 12.04 dB low (PCMU) or 18.06 dB low (PCMA).
+*
+* This is the ONE absolute-dBFS number in the repo that is a MEASUREMENT
+* rather than a statement about the scale, and it is the only one with a
+* recorded provenance — which is exactly why it is also the only shared
+* constant that converts. Three things agree that the camera it was measured
+* on spoke PCMU:
+*
+*  - 19 of this hub's 25 cameras with audio are PCMU, 5 AAC, 1 L16, 0 PCMA
+*    (codec census over 10 h of `audio: track detected`, 2026-09-11);
+*  - **-55..-26 dBFS is not a close cry on a true scale.** -26 is a quiet
+*    room. Read as a PCMU measurement the band is -43..-14, which is exactly
+*    where a cry a metre from the microphone sits;
+*  - there is no PCMA camera on this installation, so the only candidate
+*    correction is mu-law's.
+*
+* So the band is restated, not re-guessed: the offered floor stays "the QUIET
+* end of the measured band", and the band moves to where it was always really
+* sitting. {@link ituDbfsFromPreEpoch} does the arithmetic so the derivation
+* survives in the source instead of becoming a number somebody preferred.
+*
+* `Math.round` is the control's own granularity, not a fudge: the editor's
+* level field is an integer stepper and `patchAudio` clamps through
+* `clampInt`, so a fractional seed could never reach storage anyway.
+*
+* **This changes no existing rule.** It is what an editor OFFERS when the
+* level filter is switched on with nothing stored; every `dbThreshold` an
+* operator already authored is untouched, and those are a separate question
+* — see D460 on why they are declared rather than migrated.
+*
+* @dbfs-era pre-itu-pcmu
+*/
+var NC_AUDIO_DB_OFFERED = Math.round(ituDbfsFromPreEpoch("PCMU", -55));
 var NC_AUDIO_HIT_PERCENT_MIN = 1;
 var NC_AUDIO_HIT_PERCENT_MAX = 100;
 var NC_AUDIO_SAMPLING_MIN_SEC = 1;
@@ -51656,7 +51953,7 @@ function patchAudio(current, patch) {
 	const hasLabels = wantedLabels !== void 0 && wantedLabels.length > 0;
 	const mode = patch.mode ?? (has(patch, "labels") && hasLabels ? "label" : has(patch, "dbThreshold") && wantedDb !== void 0 ? "level" : hasLabels ? "label" : wantedDb !== void 0 ? "level" : null);
 	const labels = mode === "label" && hasLabels ? wantedLabels : void 0;
-	const dbThreshold = mode !== "level" ? void 0 : wantedDb ?? (patch.mode === "level" ? -55 : void 0);
+	const dbThreshold = mode !== "level" ? void 0 : wantedDb ?? (patch.mode === "level" ? NC_AUDIO_DB_OFFERED : void 0);
 	return {
 		...labels !== void 0 ? { labels: [...labels] } : {},
 		...dbThreshold !== void 0 ? { dbThreshold: clampInt(dbThreshold, NC_AUDIO_DB_MIN, 0) } : {},
@@ -52342,7 +52639,7 @@ var NC_OCCUPANCY_DEFAULTS = {
 var NC_AUDIO_SEED = {
 	hitPercent: NC_AUDIO_DEFAULTS.hitPercent,
 	samplingSeconds: NC_AUDIO_DEFAULTS.samplingSeconds,
-	dbThreshold: -55
+	dbThreshold: NC_AUDIO_DB_OFFERED
 };
 function ruleSeedForSection(section) {
 	switch (section) {
@@ -55440,8 +55737,11 @@ exports.APPLE_SA_TO_MACRO = APPLE_SA_TO_MACRO;
 exports.ARCHIVED_DEBUG_NOTES_DEFAULT_LIMIT = ARCHIVED_DEBUG_NOTES_DEFAULT_LIMIT;
 exports.AUDIO_ANALYSIS_CAP_NAME = AUDIO_ANALYSIS_CAP_NAME;
 exports.AUDIO_BACKEND_CHOICES = AUDIO_BACKEND_CHOICES;
+exports.AUDIO_CHUNK_FORMATS = require_sleep.AUDIO_CHUNK_FORMATS;
 exports.AUDIO_MACRO_LABELS = AUDIO_MACRO_LABELS;
 exports.AUDIO_PRESETS = require_canonical_hash.AUDIO_PRESETS;
+exports.AUDIO_SCALE_EPOCH_ISO = AUDIO_SCALE_EPOCH_ISO;
+exports.AUDIO_SCALE_EPOCH_MS = AUDIO_SCALE_EPOCH_MS;
 exports.AccessoriesStatusSchema = AccessoriesStatusSchema;
 exports.AccessoryKind = AccessoryKind;
 exports.AddBrokerInputSchema = AddBrokerInputSchema;
@@ -55481,12 +55781,16 @@ exports.AttachmentMediaTypeSchema = AttachmentMediaTypeSchema;
 exports.AttachmentSchema = AttachmentSchema;
 exports.AudioAnalysisResultSchema = AudioAnalysisResultSchema;
 exports.AudioAnalysisSettingsSchema = AudioAnalysisSettingsSchema;
+exports.AudioAttachDeviceInputSchema = AudioAttachDeviceInputSchema;
+exports.AudioAttachDeviceResultSchema = AudioAttachDeviceResultSchema;
+exports.AudioChunkFormatSchema = require_sleep.AudioChunkFormatSchema;
 exports.AudioChunkInputSchema = AudioChunkInputSchema;
 exports.AudioClassSummarySchema = AudioClassSummarySchema;
 exports.AudioClassificationLabelSchema = AudioClassificationLabelSchema;
 exports.AudioClassificationResultSchema = AudioClassificationResultSchema;
 exports.AudioCodecInfoSchema = AudioCodecInfoSchema;
 exports.AudioDecodeSessionConfigSchema = AudioDecodeSessionConfigSchema;
+exports.AudioDetachDeviceResultSchema = AudioDetachDeviceResultSchema;
 exports.AudioEncodeSchema = AudioEncodeSchema;
 exports.AudioEncodeSessionConfigSchema = AudioEncodeSessionConfigSchema;
 exports.AudioEncodedChunkSchema = AudioEncodedChunkSchema;
@@ -55800,6 +56104,7 @@ exports.FrameHandleSchema = require_sleep.FrameHandleSchema;
 exports.FrameInputSchema = FrameInputSchema;
 exports.FrameLazyCountersSchema = FrameLazyCountersSchema;
 exports.FrameLazyMetricsSchema = FrameLazyMetricsSchema;
+exports.G711_SCALE_CORRECTION_DB = G711_SCALE_CORRECTION_DB;
 exports.GasStatusSchema = GasStatusSchema;
 exports.GetLoggingSettingsInputSchema = GetLoggingSettingsInputSchema;
 exports.GetStreamWithCodecInputSchema = GetStreamWithCodecInputSchema;
@@ -56188,6 +56493,7 @@ exports.REACHABILITY_FAILURES_TO_OFFLINE = REACHABILITY_FAILURES_TO_OFFLINE;
 exports.REACHABILITY_POLL_INTERVAL_MS = REACHABILITY_POLL_INTERVAL_MS;
 exports.REACHABILITY_PROBE_TIMEOUT_MS = REACHABILITY_PROBE_TIMEOUT_MS;
 exports.RECOGNITION_TYPES = RECOGNITION_TYPES;
+exports.RECORDING_AUDIO_TRIGGER_OFFERED_DBFS = RECORDING_AUDIO_TRIGGER_OFFERED_DBFS;
 exports.RECORDING_EXPORT_MAX_READ_BYTES = RECORDING_EXPORT_MAX_READ_BYTES;
 exports.RECORDING_TIMELINE_BATCH_MAX = RECORDING_TIMELINE_BATCH_MAX;
 exports.REDACTED_SECRET = REDACTED_SECRET;
@@ -56539,6 +56845,7 @@ exports.asString = require_sleep.asString;
 exports.assertTimelapseCadences = assertTimelapseCadences;
 exports.audioAnalysisCapability = audioAnalysisCapability;
 exports.audioAnalyzerCapability = audioAnalyzerCapability;
+exports.audioChunkBytesPerSample = require_sleep.audioChunkBytesPerSample;
 exports.audioCodecCapability = audioCodecCapability;
 exports.audioIsFailClosed = audioIsFailClosed;
 exports.audioKindId = audioKindId;
@@ -56547,6 +56854,7 @@ exports.audioMetricsCapability = audioMetricsCapability;
 exports.audioModeOf = audioModeOf;
 exports.audioOrDefaults = audioOrDefaults;
 exports.audioPlanFromEncodeProfile = require_canonical_hash.audioPlanFromEncodeProfile;
+exports.audioScaleEraOf = audioScaleEraOf;
 exports.authProviderCapability = authProviderCapability;
 exports.autoAssignProfiles = autoAssignProfiles;
 exports.automationControlCapability = automationControlCapability;
@@ -56674,6 +56982,7 @@ exports.eventEmitterCapability = eventEmitterCapability;
 exports.eventsCapability = eventsCapability;
 exports.evictionPolicyForMode = evictionPolicyForMode;
 exports.evictionPolicyOfLocation = evictionPolicyOfLocation;
+exports.expandAudioChunkToF32le = require_sleep.expandAudioChunkToF32le;
 exports.expandCapMethods = require_sleep.expandCapMethods;
 exports.extractNestedAddonId = extractNestedAddonId;
 exports.extractSourceInfoFromMetadata = extractSourceInfoFromMetadata;
@@ -56711,6 +57020,7 @@ exports.intercomCapability = intercomCapability;
 exports.invocationFromEncodeProfile = require_canonical_hash.invocationFromEncodeProfile;
 exports.isAgentOnlyPlacement = isAgentOnlyPlacement;
 exports.isArrayOutputSchema = isArrayOutputSchema;
+exports.isAudioChunkFormat = require_sleep.isAudioChunkFormat;
 exports.isAudioLabelSelected = isAudioLabelSelected;
 exports.isAudioRule = isAudioRule;
 exports.isBaseConditionKey = isBaseConditionKey;
@@ -56737,6 +57047,7 @@ exports.isSourceCap = isSourceCap;
 exports.isStorageLocationMode = isStorageLocationMode;
 exports.isSystemDelivery = isSystemDelivery;
 exports.isVoidInput = isVoidInput;
+exports.ituDbfsFromPreEpoch = ituDbfsFromPreEpoch;
 exports.jobKindSchema = jobKindSchema;
 exports.kebabToCamel = kebabToCamel;
 exports.knownValues = knownValues;