@camstack/types 1.2.400 → 1.2.402

package/dist/interfaces/config-ui.d.ts

@@ -72,9 +72,11 @@ export interface ConfigSection {
      * inside the same top tab in `order` sequence — used for the
      * Zones tab where orchestrator (geometry CRUD) + motion-wasm
      * (motion rules) + detection-pipeline (detection rules) all
-     * contribute to one operator surface.
+     * contribute to one operator surface. `'hero'` shows the section ONCE
+     * directly under the device's hero card, outside every tab — the
+     * Consumables section (D915).
      */
-    readonly location?: 'settings' | 'top-tab';
+    readonly location?: 'settings' | 'top-tab' | 'hero';
     /** Sort order within the tab. Lower = top. */
     readonly order?: number;
     /**

package/dist/pipeline/load-balancing/effective-shares.d.ts

@@ -26,6 +26,12 @@ export interface EffectiveSharesInput {
     readonly eligibleNodes: readonly string[];
     /** nodeId → device keys that can take sessions; a node absent here lists none. */
     readonly eligibleDevices: Readonly<Record<string, readonly string[]>>;
+    /**
+     * nodeId → device keys the node's probe answered WITHOUT (D919): stored
+     * weights survive a device that left, but it takes no share — neither set
+     * nor effective — and the election's weights never name it.
+     */
+    readonly absentDevices?: Readonly<Record<string, readonly string[]>>;
     readonly policy?: SessionPlacementPolicy;
     readonly computedAt?: number | null;
     readonly trigger?: string | null;

package/dist/pipeline/load-balancing/share-election.d.ts

@@ -59,3 +59,49 @@ export type ShareElection = {
     readonly kind: 'none';
 };
 export declare function electByShare(candidates: readonly ShareCandidate[]): ShareElection;
+/**
+ * Affinity (D916, amends D913): a camera's sessions are short and frequent, and
+ * every election is a fresh one — with the recency memory rotating on purpose,
+ * one camera hopped node on 11 of 14 sessions in ten minutes, each hop a stream
+ * dial, a decode-worker fork and a cold pre-roll. The candidate a camera ran on
+ * last is kept while its deficit is within {@link SHARE_AFFINITY_TOLERANCE_SESSIONS}
+ * of the turn holder's, and while it has room (offered, not capped, not
+ * drowning). It moves only when the share is really off — and because a kept
+ * session still counts toward its candidate, the cumulative split still follows
+ * the shares: no candidate runs more than about one session over its share
+ * before its cameras leave.
+ */
+export declare const SHARE_AFFINITY_TOLERANCE_SESSIONS = 1;
+export type ShareAffinityReason = 
+/** The camera has no remembered placement (first session, or it expired). */
+'no-previous'
+/** The previous candidate is not offered this time (offline, ineligible, in backoff). */
+ | 'previous-ineligible'
+/** The previous candidate is at its cap or drowning. */
+ | 'previous-no-room'
+/** The share rule elected the previous candidate anyway. */
+ | 'previous-is-turn'
+/** Kept: the previous candidate is within the tolerance of the turn holder. */
+ | 'within-one-session'
+/** Moved: the previous candidate is more than the tolerance over its share. */
+ | 'share-off';
+/** One candidate as the election saw it — what the election line logs. */
+export interface ShareScoredCandidate {
+    readonly key: string;
+    readonly share: number;
+    readonly running: number;
+    readonly recent: number;
+    readonly deficit: number;
+}
+export interface ShareAffinityElection {
+    readonly election: ShareElection;
+    /** True when the elected candidate is the previous one. */
+    readonly sticky: boolean;
+    readonly affinityReason: ShareAffinityReason;
+    readonly previousKey: string | null;
+    /** The candidate the plain share rule elected (null when nothing was). */
+    readonly turnKey: string | null;
+    readonly scored: readonly ShareScoredCandidate[];
+}
+/** {@link electByShare}, keeping the previous candidate while the share allows it. */
+export declare function electByShareWithAffinity(candidates: readonly ShareCandidate[], previousKey: string | null, toleranceSessions?: number): ShareAffinityElection;

package/dist/{sleep-DJFUfKvA.mjs → sleep-CUp20JkO.mjs}

@@ -6028,6 +6028,10 @@ var HISTORY_UNIT_LABELS = {
 	kbps: "kbps",
 	fps: "fps"
 };
+/** The catalog field path of an item field: `<itemsPath>[].<field>` (`items[].level`). */
+function historyItemFieldPath(itemsPath, field) {
+	return `${itemsPath}[].${field}`;
+}
 /** Capture floor (ms) applied to `gauge` / `counter` series when a field states none. */
 var HISTORY_DEFAULT_MIN_INTERVAL_MS = 1e4;
 /**
@@ -6084,7 +6088,11 @@ var ContributionSectionSchema = z.object({
 		z.literal(4)
 	]).optional(),
 	tab: z.string().optional(),
-	location: z.enum(["settings", "top-tab"]).optional(),
+	location: z.enum([
+		"settings",
+		"top-tab",
+		"hero"
+	]).optional(),
 	order: z.number().optional(),
 	fields: z.array(z.any())
 });
@@ -8177,4 +8185,4 @@ function sleepCancellable(ms, signal) {
 	});
 }
 //#endregion
-export { optionalMethod as $, PeerBytesTicketSchema as $n, expandAudioChunkToF32le as $r, recordArrayItemPath as $t, HF_REPO as A, RECORD_DELETE_BATCH as An, collectHydratedFieldEntries as Ar, makeProfileBrokerId as At, describeCustomActions as B, REVALIDATE_AFTER_MS as Bn, isSecretMarker as Br, RecordFieldPathSchema as Bt, addonSliceHandleApi as C, asRecordsError as Cn, normalizeNodeId as Cr, ProfileRtspEntrySchema as Ct, createSliceHandle as D, RECORD_CLASSES as Dn, isEvent as Dr, StreamSourceSchema as Dt, createMirrorSource as E, RECORD_BATCH_MAX_BYTES as En, emitReadiness as Er, StreamSourceEntrySchema$1 as Et, DEVICE_CHILDREN_BATCH_MAX as F, RECORD_QUERY_MAX as Fn, resolveHydratedFieldValue as Fr, defineEntryKind as Ft, DEVICE_STATUS_METHOD as G, knownSecretCount as Gn, collectKeychainStoredKeys as Gr, StoredRecordKindDeclarationSchema as Gt, adminUiCapability as H, MIN_SCRUBBED_LENGTH as Hn, makeSecretMarker as Hr, RecordKindDeclarationSchema as Ht, CALLER_STAMPED_CAPABILITIES as I, RECORD_SECRET_COLLECTION_PREFIX as In, SECRET_CLEAR as Ir, entryBody as It, PROVIDER_PIN_FIELD as J, shortSecretRefHash as Jn, isSecretConfigField as Jr, defineRecordKinds as Jt, HISTORY_DEFAULT_MIN_INTERVAL_MS as K, registerKnownSecret as Kn, collectSecretConfigKeys as Kr, assertValidDeclaration as Kt, withoutCallerStamp as L, RECORD_SETTINGS_MAX_ROWS as Ln, classifySecretWrite as Lr, createRecordsAccess as Lt, RawStateResultSchema as M, RECORD_MAX_DATA_BYTES as Mn, dehydrateConfigField as Mr, parseProfileBrokerId as Mt, deviceOpsCapability as N, RECORD_MAX_INDEXES as Nn, dehydrateSchema as Nr, selectAssignedProfileSlots as Nt, DEFAULT_TOKEN_EXPIRY as O, RECORD_DATABASES as On, WELL_KNOWN_TABS as Or, SubscribeAudioChunksInputSchema as Ot, viewerUiCapability as P, RECORD_MAX_INDEX_FIELDS as Pn, hydrateSchema as Pr, makeInMemoryRecords as Pt, method as Q, PEER_BYTES_TICKET_TTL_MS as Qn, audioChunkBytesPerSample as Qr, parseSecretPath as Qt, customAction as R, RECORD_SWEEP_INTERVAL_MS as Rn, isSecretClear as Rr, assertTransactScope as Rt, invokeTrpcLeaf as S, UnknownRecordKindError as Sn, parseSecretRef as Sr, FrameHandleSchema as St, createLazyTrpcSource as T, RECORD_BATCH_MAX as Tn, createEvent as Tr, ProfileSlotStatusSchema as Tt, DEFAULT_RUNTIME_STATE_DURABILITY as U, clearKnownSecrets as Un, toSecretFieldView as Ur, RecordKindNameSchema as Ut, deviceCustomAction as V, createSecretsAccess as Vn, isSecretMarkerLike as Vr, RecordIndexSchema as Vt, DEVICE_SETTINGS_CONTRIBUTION_METHODS as W, forgetKnownSecret as Wn, REDACTED_SECRET as Wr, RecordRetentionSchema as Wt, expandCapMethods as X, PEER_BYTES_MAX_OUTSTANDING as Xn, schemaDeclaresAnyField as Xr, collectSecretLeaves as Xt, event as Y, PEER_BYTES_CHUNK_BYTES as Yn, omitTransientConfig as Yr, REMOVE_LEAF as Yt, isDeviceConfigCap as Z, PEER_BYTES_STALL_MS as Zn, AUDIO_CHUNK_FORMATS as Zr, mapSecretLeaves as Zt, readErrorI18n as _, RecordUniqueViolationError as _n, buildSecretRef as _r, CamProfileSchema as _t, asJsonArray as a, isZodSecret as an, normalizeAddonInitResult as ar, toNodeId as at, isDeviceScopedCap as b, TransactRefusedError as bn, isSecretRef as br, CameraStreamSchema as bt, asString as c, FilterRequiredError as cn, secretTreeFromPaths as cr, ReadinessTimeoutError as ct, parseJsonUnknown as d, NoCallerError as dn, collectSecretMarkerRefs as dr, scopeKey as dt, isAudioChunkFormat as ei, recordSecretCollection as en, DATAPLANE_SECRET_HEADER as er, resolveCapMount as et, hfModelUrl as f, PlaintextSecretError as fn, isSecretRefOwnedBy as fr, AudioChunkFormatSchema as ft, ErrorI18nPayloadSchema as g, RecordTooLargeError as gn, arrayItemFieldPath as gr, CAM_PROFILE_ORDER as gt, ErrorCodeSchema as h, RecordSecretUnavailableError as hn, SECRET_REF_SCHEME as hr, BrokerStatusSchema as ht, asBoolean as i, collectZodSecretPaths as in, classifyStoreError as ir, readNodePin as it, RUNTIME_DEFAULTS as j, RECORD_ID_MAX_LENGTH as jn, collectHydratedFieldValues as jr, makeSourceBrokerId as jt, HF_BASE_URL as k, RECORD_DEFAULT_MAX_DATA_BYTES as kn, WELL_KNOWN_TAB_MAP as kr, SubscribeAudioChunksResultSchema as kt, parseJsonArray as l, ForeignSecretMarkerError as ln, secretTreeFromSchema as lr, emitDownForOwnedCaps as lt, CamstackError as m, RecordNotFoundError as mn, transformSecretWrite as mr, BrokerStatsSchema as mt, sleepCancellable as n, secretArrayPrefixes as nn, DisposerChain as nr, CAP_NODE_PIN_CONTEXT_KEY as nt, asJsonObject as o, BatchTooLargeError as on, mergeSecretStatePaths as or, MODEL_FORMATS as ot, BOOT_RECOVERY_BACKOFF_MS as p, RECORDS_ERROR_CODES as pn, resolveSecretMarkers as pr, AudioStreamPickSchema as pt, HISTORY_UNIT_LABELS as q, scrubKnownSecrets as qn, isKeychainStoredField as qr, declarationsOf as qt, maskUrlCredentials as r, SECRET_META as rn, BaseAddon as rr, nodePin as rt, asNumber as s, DeclarationRefusedError as sn, parseSecretStatePath as sr, ReadinessRegistry as st, sleep as t, recordSecretRef as tn, SHARE_VIEW_KINDS as tr, systemMethod as tt, parseJsonObject as u, InvalidRecordError as un, KeychainWriteRefusedError as ur, readinessKey as ut, userError as v, RecordsError as vn, formatSecretScope as vr, CamStreamKindSchema as vt, createEventBusSliceSource as w, recordsErrorFromMessage as wn, createDurableState as wr, ProfileSlotSchema as wt, createDeviceProxy as x, UnindexedFilterError as xn, normalizeSecretOwner as xr, DecodedAudioChunkSchema as xt, DEVICE_SCOPED_CAPS as y, RevConflictError as yn, globalSecretScope as yr, CamStreamResolutionSchema as yt, defineCustomActions as z, resolveSecretViewsIn as zn, isSecretFieldView as zr, EntryDescriptorSchema as zt };
+export { method as $, PEER_BYTES_TICKET_TTL_MS as $n, audioChunkBytesPerSample as $r, parseSecretPath as $t, HF_REPO as A, RECORD_DEFAULT_MAX_DATA_BYTES as An, WELL_KNOWN_TAB_MAP as Ar, SubscribeAudioChunksResultSchema as At, describeCustomActions as B, resolveSecretViewsIn as Bn, isSecretFieldView as Br, EntryDescriptorSchema as Bt, addonSliceHandleApi as C, UnknownRecordKindError as Cn, parseSecretRef as Cr, FrameHandleSchema as Ct, createSliceHandle as D, RECORD_BATCH_MAX_BYTES as Dn, emitReadiness as Dr, StreamSourceEntrySchema$1 as Dt, createMirrorSource as E, RECORD_BATCH_MAX as En, createEvent as Er, ProfileSlotStatusSchema as Et, DEVICE_CHILDREN_BATCH_MAX as F, RECORD_MAX_INDEX_FIELDS as Fn, hydrateSchema as Fr, makeInMemoryRecords as Ft, DEVICE_STATUS_METHOD as G, forgetKnownSecret as Gn, REDACTED_SECRET as Gr, RecordRetentionSchema as Gt, adminUiCapability as H, createSecretsAccess as Hn, isSecretMarkerLike as Hr, RecordIndexSchema as Ht, CALLER_STAMPED_CAPABILITIES as I, RECORD_QUERY_MAX as In, resolveHydratedFieldValue as Ir, defineEntryKind as It, PROVIDER_PIN_FIELD as J, scrubKnownSecrets as Jn, isKeychainStoredField as Jr, declarationsOf as Jt, HISTORY_DEFAULT_MIN_INTERVAL_MS as K, knownSecretCount as Kn, collectKeychainStoredKeys as Kr, StoredRecordKindDeclarationSchema as Kt, withoutCallerStamp as L, RECORD_SECRET_COLLECTION_PREFIX as Ln, SECRET_CLEAR as Lr, entryBody as Lt, RawStateResultSchema as M, RECORD_ID_MAX_LENGTH as Mn, collectHydratedFieldValues as Mr, makeSourceBrokerId as Mt, deviceOpsCapability as N, RECORD_MAX_DATA_BYTES as Nn, dehydrateConfigField as Nr, parseProfileBrokerId as Nt, DEFAULT_TOKEN_EXPIRY as O, RECORD_CLASSES as On, isEvent as Or, StreamSourceSchema as Ot, viewerUiCapability as P, RECORD_MAX_INDEXES as Pn, dehydrateSchema as Pr, selectAssignedProfileSlots as Pt, isDeviceConfigCap as Q, PEER_BYTES_STALL_MS as Qn, AUDIO_CHUNK_FORMATS as Qr, mapSecretLeaves as Qt, customAction as R, RECORD_SETTINGS_MAX_ROWS as Rn, classifySecretWrite as Rr, createRecordsAccess as Rt, invokeTrpcLeaf as S, UnindexedFilterError as Sn, normalizeSecretOwner as Sr, DecodedAudioChunkSchema as St, createLazyTrpcSource as T, recordsErrorFromMessage as Tn, createDurableState as Tr, ProfileSlotSchema as Tt, DEFAULT_RUNTIME_STATE_DURABILITY as U, MIN_SCRUBBED_LENGTH as Un, makeSecretMarker as Ur, RecordKindDeclarationSchema as Ut, deviceCustomAction as V, REVALIDATE_AFTER_MS as Vn, isSecretMarker as Vr, RecordFieldPathSchema as Vt, DEVICE_SETTINGS_CONTRIBUTION_METHODS as W, clearKnownSecrets as Wn, toSecretFieldView as Wr, RecordKindNameSchema as Wt, expandCapMethods as X, PEER_BYTES_CHUNK_BYTES as Xn, omitTransientConfig as Xr, REMOVE_LEAF as Xt, event as Y, shortSecretRefHash as Yn, isSecretConfigField as Yr, defineRecordKinds as Yt, historyItemFieldPath as Z, PEER_BYTES_MAX_OUTSTANDING as Zn, schemaDeclaresAnyField as Zr, collectSecretLeaves as Zt, readErrorI18n as _, RecordTooLargeError as _n, arrayItemFieldPath as _r, CAM_PROFILE_ORDER as _t, asJsonArray as a, collectZodSecretPaths as an, classifyStoreError as ar, readNodePin as at, isDeviceScopedCap as b, RevConflictError as bn, globalSecretScope as br, CamStreamResolutionSchema as bt, asString as c, DeclarationRefusedError as cn, parseSecretStatePath as cr, ReadinessRegistry as ct, parseJsonUnknown as d, InvalidRecordError as dn, KeychainWriteRefusedError as dr, readinessKey as dt, expandAudioChunkToF32le as ei, recordArrayItemPath as en, PeerBytesTicketSchema as er, optionalMethod as et, hfModelUrl as f, NoCallerError as fn, collectSecretMarkerRefs as fr, scopeKey as ft, ErrorI18nPayloadSchema as g, RecordSecretUnavailableError as gn, SECRET_REF_SCHEME as gr, BrokerStatusSchema as gt, ErrorCodeSchema as h, RecordNotFoundError as hn, transformSecretWrite as hr, BrokerStatsSchema as ht, asBoolean as i, SECRET_META as in, BaseAddon as ir, nodePin as it, RUNTIME_DEFAULTS as j, RECORD_DELETE_BATCH as jn, collectHydratedFieldEntries as jr, makeProfileBrokerId as jt, HF_BASE_URL as k, RECORD_DATABASES as kn, WELL_KNOWN_TABS as kr, SubscribeAudioChunksInputSchema as kt, parseJsonArray as l, FilterRequiredError as ln, secretTreeFromPaths as lr, ReadinessTimeoutError as lt, CamstackError as m, RECORDS_ERROR_CODES as mn, resolveSecretMarkers as mr, AudioStreamPickSchema as mt, sleepCancellable as n, recordSecretRef as nn, SHARE_VIEW_KINDS as nr, systemMethod as nt, asJsonObject as o, isZodSecret as on, normalizeAddonInitResult as or, toNodeId as ot, BOOT_RECOVERY_BACKOFF_MS as p, PlaintextSecretError as pn, isSecretRefOwnedBy as pr, AudioChunkFormatSchema as pt, HISTORY_UNIT_LABELS as q, registerKnownSecret as qn, collectSecretConfigKeys as qr, assertValidDeclaration as qt, maskUrlCredentials as r, secretArrayPrefixes as rn, DisposerChain as rr, CAP_NODE_PIN_CONTEXT_KEY as rt, asNumber as s, BatchTooLargeError as sn, mergeSecretStatePaths as sr, MODEL_FORMATS as st, sleep as t, isAudioChunkFormat as ti, recordSecretCollection as tn, DATAPLANE_SECRET_HEADER as tr, resolveCapMount as tt, parseJsonObject as u, ForeignSecretMarkerError as un, secretTreeFromSchema as ur, emitDownForOwnedCaps as ut, userError as v, RecordUniqueViolationError as vn, buildSecretRef as vr, CamProfileSchema as vt, createEventBusSliceSource as w, asRecordsError as wn, normalizeNodeId as wr, ProfileRtspEntrySchema as wt, createDeviceProxy as x, TransactRefusedError as xn, isSecretRef as xr, CameraStreamSchema as xt, DEVICE_SCOPED_CAPS as y, RecordsError as yn, formatSecretScope as yr, CamStreamKindSchema as yt, defineCustomActions as z, RECORD_SWEEP_INTERVAL_MS as zn, isSecretClear as zr, assertTransactScope as zt };

package/dist/{sleep-CD18m9HF.js → sleep-DVovpDRU.js}

@@ -6028,6 +6028,10 @@ var HISTORY_UNIT_LABELS = {
 	kbps: "kbps",
 	fps: "fps"
 };
+/** The catalog field path of an item field: `<itemsPath>[].<field>` (`items[].level`). */
+function historyItemFieldPath(itemsPath, field) {
+	return `${itemsPath}[].${field}`;
+}
 /** Capture floor (ms) applied to `gauge` / `counter` series when a field states none. */
 var HISTORY_DEFAULT_MIN_INTERVAL_MS = 1e4;
 /**
@@ -6084,7 +6088,11 @@ var ContributionSectionSchema = zod.z.object({
 		zod.z.literal(4)
 	]).optional(),
 	tab: zod.z.string().optional(),
-	location: zod.z.enum(["settings", "top-tab"]).optional(),
+	location: zod.z.enum([
+		"settings",
+		"top-tab",
+		"hero"
+	]).optional(),
 	order: zod.z.number().optional(),
 	fields: zod.z.array(zod.z.any())
 });
@@ -9077,6 +9085,12 @@ Object.defineProperty(exports, "hfModelUrl", {
 		return hfModelUrl;
 	}
 });
+Object.defineProperty(exports, "historyItemFieldPath", {
+	enumerable: true,
+	get: function() {
+		return historyItemFieldPath;
+	}
+});
 Object.defineProperty(exports, "hydrateSchema", {
 	enumerable: true,
 	get: function() {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@camstack/types",
-  "version": "1.2.400",
+  "version": "1.2.402",
   "description": "Shared types, interfaces, and model catalogs for the CamStack detection ecosystem",
   "keywords": [
     "camstack",