@camstack/types 1.2.118 → 1.2.119

package/dist/addon/base-addon.d.ts

@@ -189,7 +189,65 @@ export declare abstract class BaseAddon<TConfig extends object = Record<string,
     protected globalSettingsSchema(_cap?: string): ConfigUISchema | null;
     /** Override to provide device-level settings UI schema. */
     protected deviceSettingsSchema(): ConfigUISchema | null;
+    /**
+     * INTEGRATION-LEVEL SETTINGS — declare which of this addon's global sections
+     * ARE the configuration of its integration.
+     *
+     * Return the `ConfigSection.id`s, from {@link globalSettingsSchema}, that an
+     * operator should find on the addon's integration page (System →
+     * Integrations → <name>) rather than only in the cluster-wide list of every
+     * addon. Empty (the default) means the addon has no integration-level
+     * settings and no such surface is offered — this is opt-in, because whether
+     * an addon's configuration IS its integration's configuration depends on the
+     * nature of the integration.
+     *
+     * WHAT THIS IS NOT. It is not a scope. The selected sections keep living in
+     * the ONE global schema, in the ONE addon store, written by the ONE
+     * `updateGlobalSettings` path. There is deliberately no
+     * `updateIntegrationSettings`: a second write path is how a surface acquires
+     * a second store key, and this repo has shipped that twice (`btmPath@hub`,
+     * D266). Selecting sections cannot introduce a key that selecting cannot.
+     *
+     * WHY IT IS A LIST OF SECTION IDS AND NOT A MARKER ON THE SECTION.
+     * `ConfigFieldBase` used to carry `scope?: 'device' | 'global'` and it was
+     * removed with the reason recorded at
+     * `packages/types/src/interfaces/config-ui.ts:249` — *"a field's scope is
+     * determined by WHICH schema it lives in, not by a field-level marker."* A
+     * marker sprinkled across sections also has to borrow a field that already
+     * means something else; borrowing `section.tab` put the literal word
+     * "integration" into an operator-facing tab bar, because `tab` means "how to
+     * GROUP this visually" and cannot also mean "where this lives" (D269
+     * supersedes D268). One declaration, in one place, next to the schema whose
+     * ids it names.
+     */
+    protected integrationSettingSections(): readonly string[];
     getGlobalSettings(overlay?: Record<string, unknown>, cap?: string, nodeId?: string): Promise<ConfigUISchemaWithValues | null>;
+    /**
+     * The integration-level view of this addon's settings: exactly the sections
+     * named by {@link integrationSettingSections}, hydrated from the SAME store
+     * `getGlobalSettings` reads, and narrowed to cluster-scoped fields.
+     *
+     * Returns `null` when the addon declared nothing — an addon that opts out has
+     * no integration settings surface at all, rather than an empty one that reads
+     * as a failed load.
+     *
+     * Three properties hold BY CONSTRUCTION, which is why they are here in core
+     * and not in whichever UI happens to render this:
+     *
+     *  1. **One key.** The payload is a SUBSET of the global schema, so a field
+     *     shown here is the same field, with the same bare key, that the addon's
+     *     own page shows. There is no integration-specific writer — callers save
+     *     through `updateGlobalSettings` — so a second store key is unreachable,
+     *     not merely discouraged.
+     *  2. **No node scope.** `perNode: true` fields are DROPPED. Their store key
+     *     is `<key>@<nodeId>` and an integration is not a node; whichever node
+     *     such a field silently picked would be a wrong answer for the operator
+     *     who opened the page (D266).
+     *  3. **No silent typo.** A declared id that names no section throws. The
+     *     alternative — skip it — turns a rename into a surface that quietly
+     *     empties, which looks exactly like an addon with nothing to configure.
+     */
+    getIntegrationSettings(nodeId?: string): Promise<ConfigUISchemaWithValues | null>;
     /**
      * The raw addon store PROJECTED onto the target node's bare per-node keys:
      * every `perNode: true` field carries THAT node's scoped value on its bare

package/dist/addon.js

@@ -1,6 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_event_category = require("./event-category-BaEgqJNv.js");
-const require_sleep = require("./sleep-9d8tJRbO.js");
+const require_sleep = require("./sleep-DUxF5DdC.js");
 const require_err_msg = require("./err-msg-COpsHMw2.js");
 //#region src/generated/cap-input-defaults.ts
 /**

package/dist/addon.mjs

@@ -1,5 +1,5 @@
 import { t as EventCategory } from "./event-category-BZL-fdNj.mjs";
-import { B as ReadinessRegistry, E as adminUiCapability, L as nodePin, R as readNodePin, St as emitReadiness, T as DeviceType, V as ReadinessTimeoutError, W as scopeKey, _t as DisposerChain, a as asJsonObject, b as deviceOpsCapability, d as BOOT_RECOVERY_BACKOFF_MS, f as DEVICE_SCOPED_CAPS, gt as DATAPLANE_SECRET_HEADER, h as createEventBusSliceSource, j as expandCapMethods, m as createDeviceProxy, p as isDeviceScopedCap, s as asString, t as sleep, u as parseJsonUnknown, vt as BaseAddon, x as viewerUiCapability, yt as normalizeAddonInitResult } from "./sleep-Dolp38qx.mjs";
+import { B as ReadinessRegistry, E as adminUiCapability, L as nodePin, R as readNodePin, St as emitReadiness, T as DeviceType, V as ReadinessTimeoutError, W as scopeKey, _t as DisposerChain, a as asJsonObject, b as deviceOpsCapability, d as BOOT_RECOVERY_BACKOFF_MS, f as DEVICE_SCOPED_CAPS, gt as DATAPLANE_SECRET_HEADER, h as createEventBusSliceSource, j as expandCapMethods, m as createDeviceProxy, p as isDeviceScopedCap, s as asString, t as sleep, u as parseJsonUnknown, vt as BaseAddon, x as viewerUiCapability, yt as normalizeAddonInitResult } from "./sleep-C9C8EoK8.mjs";
 import { t as errMsg } from "./err-msg-IQTHeDzc.mjs";
 //#region src/generated/cap-input-defaults.ts
 /**

package/dist/capabilities/addon-settings.cap.d.ts

@@ -126,6 +126,35 @@ export declare const addonSettingsCapability: {
         }, z.core.$strip>, z.ZodObject<{
             success: z.ZodLiteral<true>;
         }, z.core.$strip>, "mutation">;
+        readonly getIntegrationSettings: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
+            addonId: z.ZodString;
+            nodeId: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>, z.ZodNullable<z.ZodObject<{
+            tabs: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                label: z.ZodString;
+                icon: z.ZodString;
+                order: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$strip>>>;
+            sections: z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                title: z.ZodString;
+                description: z.ZodOptional<z.ZodString>;
+                style: z.ZodOptional<z.ZodEnum<{
+                    card: "card";
+                    accordion: "accordion";
+                }>>;
+                defaultCollapsed: z.ZodOptional<z.ZodBoolean>;
+                columns: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<1>, z.ZodLiteral<2>, z.ZodLiteral<3>, z.ZodLiteral<4>]>>;
+                tab: z.ZodOptional<z.ZodString>;
+                location: z.ZodOptional<z.ZodEnum<{
+                    settings: "settings";
+                    "top-tab": "top-tab";
+                }>>;
+                order: z.ZodOptional<z.ZodNumber>;
+                fields: z.ZodArray<z.ZodAny>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>>, import("./capability-definition.js").CapabilityMethodKind>;
         readonly getDeviceSettings: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
             addonId: z.ZodString;
             deviceId: z.ZodNumber;

package/dist/capabilities/audio-analyzer.cap.d.ts

@@ -61,9 +61,13 @@ export type AudioBackendChoice = (typeof AUDIO_BACKEND_CHOICES)[number]['value']
 /**
  * Shared shape of the audio-analyzer addon's global settings.
  * `audioBackend` = operator choice (wins); `probedBestAudioBackend`
- * = hint refreshed by `reprobeAudioEngine`. `selectedAudioModel`
- * replaces the orchestrator's legacy
- * `AgentPipelineSettings.audio.modelId`.
+ * = hint refreshed by `reprobeAudioEngine`.
+ *
+ * There is NO model id here. The backend IS the model: YAMNet ships one
+ * ONNX graph and Apple SoundAnalysis is a built-in with nothing swappable,
+ * so `createAudioPipeline` takes a backend and no model. A
+ * `selectedAudioModel` select shipped here until 2026-08-28 (D272) and
+ * reached inference on no path — it was a log field.
  *
  * NOTE — enable/disable is NOT stored here:
  *   - per-device: `audio-analysis` wrapper cap + `setWrapperActive`
@@ -75,7 +79,6 @@ export type AudioBackendChoice = (typeof AUDIO_BACKEND_CHOICES)[number]['value']
 export interface AudioAnalyzerGlobalConfig {
     readonly audioBackend: AudioBackendChoice;
     readonly probedBestAudioBackend: string;
-    readonly selectedAudioModel: string;
 }
 export declare const DEFAULT_AUDIO_ANALYZER_CONFIG: AudioAnalyzerGlobalConfig;
 export declare const audioAnalyzerCapability: {

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

@@ -209,6 +209,13 @@ export type AppRouter = TrpcCoreRouter<{
             output: z.infer<typeof addonSettingsCapability.methods.updateGlobalSettings.output>;
             meta: object;
         }>;
+        getIntegrationSettings: TRPCQueryProcedure<{
+            input: {
+                [x: string]: unknown;
+            } & z.input<typeof addonSettingsCapability.methods.getIntegrationSettings.input>;
+            output: z.infer<typeof addonSettingsCapability.methods.getIntegrationSettings.output>;
+            meta: object;
+        }>;
         getDeviceSettings: 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: 975 method paths across 125 capabilities.
+ * Coverage: 976 method paths across 125 capabilities.
  */
 import type { CapabilityMethodAccess } from '../capabilities/capability-definition.js';
 export interface MethodAccessRecord {

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

@@ -56,7 +56,7 @@ import type { userManagementCapability } from '../capabilities/user-management.c
 export interface SystemProxy {
     readonly addonPages: Pick<InferProvider<typeof addonPagesCapability>, 'listPages'>;
     readonly addons: Pick<InferProvider<typeof addonsCapability>, 'list' | 'getLogs' | 'listPackages' | 'installPackage' | 'installFromWorkspace' | 'isWorkspaceAvailable' | 'listWorkspacePackages' | 'uninstallPackage' | 'reloadPackages' | 'searchAvailable' | 'listUpdates' | 'updatePackage' | 'rollbackPackage' | 'forceRefresh' | 'restartServer' | 'getLastRestart' | 'listFrameworkPackages' | 'listCapabilityProviders' | 'setCapabilityProviderEnabled' | 'getVersions' | 'restartAddon' | 'retryLoad' | 'getAutoUpdateSettings' | 'setAutoUpdateSettings' | 'getAddonAutoUpdate' | 'setAddonAutoUpdate' | 'applyAutoUpdateToAll' | 'custom' | 'startJob' | 'getJob' | 'listJobs' | 'cancelJob' | 'onAddonLogs'>;
-    readonly addonSettings: Pick<InferProvider<typeof addonSettingsCapability>, 'getGlobalSettings' | 'updateGlobalSettings'>;
+    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'>;

package/dist/index.js

@@ -1,6 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_event_category = require("./event-category-BaEgqJNv.js");
-const require_sleep = require("./sleep-9d8tJRbO.js");
+const require_sleep = require("./sleep-DUxF5DdC.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");
@@ -5128,6 +5128,10 @@ var addonSettingsCapability = {
 			kind: "mutation",
 			auth: "admin"
 		}),
+		getIntegrationSettings: require_sleep.method(zod.z.object({
+			addonId: zod.z.string(),
+			nodeId: zod.z.string().optional()
+		}), SettingsSchemaWithValuesSchema.nullable()),
 		getDeviceSettings: require_sleep.method(zod.z.object({
 			addonId: zod.z.string(),
 			deviceId: zod.z.number(),
@@ -5549,8 +5553,7 @@ var AUDIO_BACKEND_CHOICES = [
 ];
 var DEFAULT_AUDIO_ANALYZER_CONFIG = {
 	audioBackend: "auto",
-	probedBestAudioBackend: "",
-	selectedAudioModel: ""
+	probedBestAudioBackend: ""
 };
 var audioAnalyzerCapability = {
 	name: "audio-analyzer",
@@ -37385,6 +37388,12 @@ var METHOD_ACCESS_MAP = Object.freeze({
 		addonId: null,
 		access: "view"
 	},
+	"addonSettings.getIntegrationSettings": {
+		capName: "addon-settings",
+		capScope: "system",
+		addonId: null,
+		access: "view"
+	},
 	"addonSettings.updateDeviceSettings": {
 		capName: "addon-settings",
 		capScope: "system",
@@ -45639,7 +45648,8 @@ function createSystemProxy(api) {
 		},
 		addonSettings: {
 			getGlobalSettings: (input) => dispatch("addonSettings", "getGlobalSettings", "query", input),
-			updateGlobalSettings: (input) => dispatch("addonSettings", "updateGlobalSettings", "mutation", input)
+			updateGlobalSettings: (input) => dispatch("addonSettings", "updateGlobalSettings", "mutation", input),
+			getIntegrationSettings: (input) => dispatch("addonSettings", "getIntegrationSettings", "query", input)
 		},
 		addonWidgets: { listWidgets: (input) => dispatch("addonWidgets", "listWidgets", "query", input) },
 		alerts: {

package/dist/index.mjs

@@ -1,5 +1,5 @@
 import { t as EventCategory } from "./event-category-BZL-fdNj.mjs";
-import { $ as DecodedFrameSchema, A as event, B as ReadinessRegistry, C as DeviceFeature, Ct as isEvent, D as DEFAULT_RUNTIME_STATE_DURABILITY, Dt as collectHydratedFieldValues, E as adminUiCapability, Et as collectHydratedFieldEntries, F as systemMethod, G as BrokerStatsSchema, H as emitDownForOwnedCaps, I as CAP_NODE_PIN_CONTEXT_KEY, J as CamProfileSchema, K as BrokerStatusSchema, L as nodePin, M as isDeviceConfigCap, N as method, O as DEVICE_SETTINGS_CONTRIBUTION_METHODS, Ot as hydrateSchema, P as resolveCapMount, Q as DecodedAudioChunkSchema, R as readNodePin, S as ChargingStatus, St as emitReadiness, T as DeviceType, Tt as WELL_KNOWN_TAB_MAP, U as readinessKey, V as ReadinessTimeoutError, W as scopeKey, X as CamStreamResolutionSchema, Y as CamStreamKindSchema, Z as CameraStreamSchema, _ as createMirrorSource, _t as DisposerChain, a as asJsonObject, at as ProfileSlotStatusSchema, b as deviceOpsCapability, bt as createDurableState, c as parseJsonArray, ct as SubscribeAudioChunksInputSchema, d as BOOT_RECOVERY_BACKOFF_MS, dt as SubscribeFramesResultSchema, et as EncodedPacketSchema, f as DEVICE_SCOPED_CAPS, ft as makeProfileBrokerId, g as createLazyTrpcSource, gt as DATAPLANE_SECRET_HEADER, h as createEventBusSliceSource, ht as selectAssignedProfileSlots, i as asJsonArray, it as ProfileSlotSchema, j as expandCapMethods, k as DEVICE_STATUS_METHOD, kt as resolveHydratedFieldValue, l as parseJsonObject, lt as SubscribeAudioChunksResultSchema, m as createDeviceProxy, mt as parseProfileBrokerId, n as sleepCancellable, nt as FrameHandleSchema, o as asNumber, ot as StreamSourceEntrySchema, p as isDeviceScopedCap, pt as makeSourceBrokerId, q as CAM_PROFILE_ORDER, r as asBoolean, rt as ProfileRtspEntrySchema, s as asString, st as StreamSourceSchema, t as sleep, tt as FrameHandleFormatSchema, u as parseJsonUnknown, ut as SubscribeFramesInputSchema, v as createSliceHandle, vt as BaseAddon, w as DeviceRole, wt as WELL_KNOWN_TABS, x as viewerUiCapability, xt as createEvent, y as RawStateResultSchema, yt as normalizeAddonInitResult, z as toNodeId } from "./sleep-Dolp38qx.mjs";
+import { $ as DecodedFrameSchema, A as event, B as ReadinessRegistry, C as DeviceFeature, Ct as isEvent, D as DEFAULT_RUNTIME_STATE_DURABILITY, Dt as collectHydratedFieldValues, E as adminUiCapability, Et as collectHydratedFieldEntries, F as systemMethod, G as BrokerStatsSchema, H as emitDownForOwnedCaps, I as CAP_NODE_PIN_CONTEXT_KEY, J as CamProfileSchema, K as BrokerStatusSchema, L as nodePin, M as isDeviceConfigCap, N as method, O as DEVICE_SETTINGS_CONTRIBUTION_METHODS, Ot as hydrateSchema, P as resolveCapMount, Q as DecodedAudioChunkSchema, R as readNodePin, S as ChargingStatus, St as emitReadiness, T as DeviceType, Tt as WELL_KNOWN_TAB_MAP, U as readinessKey, V as ReadinessTimeoutError, W as scopeKey, X as CamStreamResolutionSchema, Y as CamStreamKindSchema, Z as CameraStreamSchema, _ as createMirrorSource, _t as DisposerChain, a as asJsonObject, at as ProfileSlotStatusSchema, b as deviceOpsCapability, bt as createDurableState, c as parseJsonArray, ct as SubscribeAudioChunksInputSchema, d as BOOT_RECOVERY_BACKOFF_MS, dt as SubscribeFramesResultSchema, et as EncodedPacketSchema, f as DEVICE_SCOPED_CAPS, ft as makeProfileBrokerId, g as createLazyTrpcSource, gt as DATAPLANE_SECRET_HEADER, h as createEventBusSliceSource, ht as selectAssignedProfileSlots, i as asJsonArray, it as ProfileSlotSchema, j as expandCapMethods, k as DEVICE_STATUS_METHOD, kt as resolveHydratedFieldValue, l as parseJsonObject, lt as SubscribeAudioChunksResultSchema, m as createDeviceProxy, mt as parseProfileBrokerId, n as sleepCancellable, nt as FrameHandleSchema, o as asNumber, ot as StreamSourceEntrySchema, p as isDeviceScopedCap, pt as makeSourceBrokerId, q as CAM_PROFILE_ORDER, r as asBoolean, rt as ProfileRtspEntrySchema, s as asString, st as StreamSourceSchema, t as sleep, tt as FrameHandleFormatSchema, u as parseJsonUnknown, ut as SubscribeFramesInputSchema, v as createSliceHandle, vt as BaseAddon, w as DeviceRole, wt as WELL_KNOWN_TABS, x as viewerUiCapability, xt as createEvent, y as RawStateResultSchema, yt as normalizeAddonInitResult, z as toNodeId } from "./sleep-C9C8EoK8.mjs";
 import { a as buildAudioArgs, c as buildVideoArgs, d as logBannerArgs, f as pickVideoEncoder, i as audioPlanFromEncodeProfile, l as invocationFromEncodeProfile, n as Fmp4BoxSplitter, o as buildFfmpegArgs, r as AUDIO_PRESETS, s as buildInputArgs, t as canonicalHash, u as isSoftwareDecode } from "./canonical-hash-rO1sRmEK.mjs";
 import { EventSourceType } from "./enums.mjs";
 import { t as errMsg } from "./err-msg-IQTHeDzc.mjs";
@@ -5127,6 +5127,10 @@ var addonSettingsCapability = {
 			kind: "mutation",
 			auth: "admin"
 		}),
+		getIntegrationSettings: method(z.object({
+			addonId: z.string(),
+			nodeId: z.string().optional()
+		}), SettingsSchemaWithValuesSchema.nullable()),
 		getDeviceSettings: method(z.object({
 			addonId: z.string(),
 			deviceId: z.number(),
@@ -5548,8 +5552,7 @@ var AUDIO_BACKEND_CHOICES = [
 ];
 var DEFAULT_AUDIO_ANALYZER_CONFIG = {
 	audioBackend: "auto",
-	probedBestAudioBackend: "",
-	selectedAudioModel: ""
+	probedBestAudioBackend: ""
 };
 var audioAnalyzerCapability = {
 	name: "audio-analyzer",
@@ -37377,6 +37380,12 @@ var METHOD_ACCESS_MAP = Object.freeze({
 		addonId: null,
 		access: "view"
 	},
+	"addonSettings.getIntegrationSettings": {
+		capName: "addon-settings",
+		capScope: "system",
+		addonId: null,
+		access: "view"
+	},
 	"addonSettings.updateDeviceSettings": {
 		capName: "addon-settings",
 		capScope: "system",
@@ -45631,7 +45640,8 @@ function createSystemProxy(api) {
 		},
 		addonSettings: {
 			getGlobalSettings: (input) => dispatch("addonSettings", "getGlobalSettings", "query", input),
-			updateGlobalSettings: (input) => dispatch("addonSettings", "updateGlobalSettings", "mutation", input)
+			updateGlobalSettings: (input) => dispatch("addonSettings", "updateGlobalSettings", "mutation", input),
+			getIntegrationSettings: (input) => dispatch("addonSettings", "getIntegrationSettings", "query", input)
 		},
 		addonWidgets: { listWidgets: (input) => dispatch("addonWidgets", "listWidgets", "query", input) },
 		alerts: {

package/dist/interfaces/addon.d.ts

@@ -790,6 +790,17 @@ export interface ICamstackAddon {
      *  persisted store. */
     getGlobalSettings?(overlay?: Record<string, unknown>, cap?: string, nodeId?: string): Promise<ConfigUISchemaWithValues | null>;
     updateGlobalSettings?(patch: Record<string, unknown>, nodeId?: string): Promise<void>;
+    /**
+     * Integration-level settings — the subset of the global schema the addon
+     * declared as its INTEGRATION's configuration (`BaseAddon.
+     * integrationSettingSections`). `null` ⇒ none declared, so the surface is
+     * not offered.
+     *
+     * There is no matching updater on purpose: the payload is a subset of the
+     * global schema, so `updateGlobalSettings` is the writer and the store key
+     * stays the one bare key. See `addon-settings.cap.ts`.
+     */
+    getIntegrationSettings?(nodeId?: string): Promise<ConfigUISchemaWithValues | null>;
     /** Level 2 — per-device settings (schema + values). Appears in
      *  Device Overrides. */
     getDeviceSettings?(deviceId: number): Promise<ConfigUISchemaWithValues>;

package/dist/{sleep-Dolp38qx.mjs → sleep-C9C8EoK8.mjs}

@@ -685,6 +685,40 @@ var BaseAddon = class {
 	deviceSettingsSchema() {
 		return null;
 	}
+	/**
+	* INTEGRATION-LEVEL SETTINGS — declare which of this addon's global sections
+	* ARE the configuration of its integration.
+	*
+	* Return the `ConfigSection.id`s, from {@link globalSettingsSchema}, that an
+	* operator should find on the addon's integration page (System →
+	* Integrations → <name>) rather than only in the cluster-wide list of every
+	* addon. Empty (the default) means the addon has no integration-level
+	* settings and no such surface is offered — this is opt-in, because whether
+	* an addon's configuration IS its integration's configuration depends on the
+	* nature of the integration.
+	*
+	* WHAT THIS IS NOT. It is not a scope. The selected sections keep living in
+	* the ONE global schema, in the ONE addon store, written by the ONE
+	* `updateGlobalSettings` path. There is deliberately no
+	* `updateIntegrationSettings`: a second write path is how a surface acquires
+	* a second store key, and this repo has shipped that twice (`btmPath@hub`,
+	* D266). Selecting sections cannot introduce a key that selecting cannot.
+	*
+	* WHY IT IS A LIST OF SECTION IDS AND NOT A MARKER ON THE SECTION.
+	* `ConfigFieldBase` used to carry `scope?: 'device' | 'global'` and it was
+	* removed with the reason recorded at
+	* `packages/types/src/interfaces/config-ui.ts:249` — *"a field's scope is
+	* determined by WHICH schema it lives in, not by a field-level marker."* A
+	* marker sprinkled across sections also has to borrow a field that already
+	* means something else; borrowing `section.tab` put the literal word
+	* "integration" into an operator-facing tab bar, because `tab` means "how to
+	* GROUP this visually" and cannot also mean "where this lives" (D269
+	* supersedes D268). One declaration, in one place, next to the schema whose
+	* ids it names.
+	*/
+	integrationSettingSections() {
+		return [];
+	}
 	async getGlobalSettings(overlay, cap, nodeId) {
 		const schema = this.globalSettingsSchema(cap);
 		if (!schema) return { sections: [] };
@@ -695,6 +729,55 @@ var BaseAddon = class {
 		} : projected);
 	}
 	/**
+	* The integration-level view of this addon's settings: exactly the sections
+	* named by {@link integrationSettingSections}, hydrated from the SAME store
+	* `getGlobalSettings` reads, and narrowed to cluster-scoped fields.
+	*
+	* Returns `null` when the addon declared nothing — an addon that opts out has
+	* no integration settings surface at all, rather than an empty one that reads
+	* as a failed load.
+	*
+	* Three properties hold BY CONSTRUCTION, which is why they are here in core
+	* and not in whichever UI happens to render this:
+	*
+	*  1. **One key.** The payload is a SUBSET of the global schema, so a field
+	*     shown here is the same field, with the same bare key, that the addon's
+	*     own page shows. There is no integration-specific writer — callers save
+	*     through `updateGlobalSettings` — so a second store key is unreachable,
+	*     not merely discouraged.
+	*  2. **No node scope.** `perNode: true` fields are DROPPED. Their store key
+	*     is `<key>@<nodeId>` and an integration is not a node; whichever node
+	*     such a field silently picked would be a wrong answer for the operator
+	*     who opened the page (D266).
+	*  3. **No silent typo.** A declared id that names no section throws. The
+	*     alternative — skip it — turns a rename into a surface that quietly
+	*     empties, which looks exactly like an addon with nothing to configure.
+	*/
+	async getIntegrationSettings(nodeId) {
+		const declared = this.integrationSettingSections();
+		if (declared.length === 0) return null;
+		const schema = this.globalSettingsSchema();
+		if (!schema) throw new Error(`${this.constructor.name}: integrationSettingSections() names [${declared.join(", ")}] but globalSettingsSchema() returns null.`);
+		const byId = new Map(schema.sections.map((section) => [section.id, section]));
+		const sections = [];
+		for (const id of declared) {
+			const section = byId.get(id);
+			if (!section) throw new Error(`${this.constructor.name}: integrationSettingSections() names unknown section "${id}". Known sections: [${[...byId.keys()].join(", ")}].`);
+			const fields = dropPerNodeFields(section.fields);
+			if (fields.length === 0) continue;
+			sections.push({
+				...section,
+				fields
+			});
+		}
+		if (sections.length === 0) return null;
+		const projected = await this.resolveGlobalStore(nodeId);
+		return hydrateSchema({
+			...schema,
+			sections
+		}, projected);
+	}
+	/**
 	* The raw addon store PROJECTED onto the target node's bare per-node keys:
 	* every `perNode: true` field carries THAT node's scoped value on its bare
 	* key (absent scoped key ⇒ key absent, so the schema `default` wins — no
@@ -998,6 +1081,41 @@ var BaseAddon = class {
 * `hydrateSchema` does. Valueless structural fields (separator/info/…)
 * don't declare `perNode` and are excluded by the `in` narrowing.
 */
+/**
+* The same fields with every `perNode: true` one removed, recursing into layout
+* containers exactly as {@link collectPerNodeFieldKeys} does. A container left
+* with no child is dropped rather than rendered empty.
+*
+* Used by `getIntegrationSettings`: an integration is not a node, so a field
+* whose store key is `<key>@<nodeId>` has no node to belong to there.
+*/
+function dropPerNodeFields(fields) {
+	const kept = [];
+	for (const field of fields) {
+		if (field.type === "group") {
+			const inner = dropPerNodeFields(field.fields);
+			if (inner.length > 0) kept.push({
+				...field,
+				fields: inner
+			});
+			continue;
+		}
+		if (field.type === "sub-tabs") {
+			const tabs = field.tabs.map((tab) => ({
+				...tab,
+				fields: dropPerNodeFields(tab.fields)
+			})).filter((tab) => tab.fields.length > 0);
+			if (tabs.length > 0) kept.push({
+				...field,
+				tabs
+			});
+			continue;
+		}
+		if ("perNode" in field && field.perNode === true) continue;
+		kept.push(field);
+	}
+	return kept;
+}
 function collectPerNodeFieldKeys(fields) {
 	const collected = [];
 	for (const field of fields) {

package/dist/{sleep-9d8tJRbO.js → sleep-DUxF5DdC.js}

@@ -685,6 +685,40 @@ var BaseAddon = class {
 	deviceSettingsSchema() {
 		return null;
 	}
+	/**
+	* INTEGRATION-LEVEL SETTINGS — declare which of this addon's global sections
+	* ARE the configuration of its integration.
+	*
+	* Return the `ConfigSection.id`s, from {@link globalSettingsSchema}, that an
+	* operator should find on the addon's integration page (System →
+	* Integrations → <name>) rather than only in the cluster-wide list of every
+	* addon. Empty (the default) means the addon has no integration-level
+	* settings and no such surface is offered — this is opt-in, because whether
+	* an addon's configuration IS its integration's configuration depends on the
+	* nature of the integration.
+	*
+	* WHAT THIS IS NOT. It is not a scope. The selected sections keep living in
+	* the ONE global schema, in the ONE addon store, written by the ONE
+	* `updateGlobalSettings` path. There is deliberately no
+	* `updateIntegrationSettings`: a second write path is how a surface acquires
+	* a second store key, and this repo has shipped that twice (`btmPath@hub`,
+	* D266). Selecting sections cannot introduce a key that selecting cannot.
+	*
+	* WHY IT IS A LIST OF SECTION IDS AND NOT A MARKER ON THE SECTION.
+	* `ConfigFieldBase` used to carry `scope?: 'device' | 'global'` and it was
+	* removed with the reason recorded at
+	* `packages/types/src/interfaces/config-ui.ts:249` — *"a field's scope is
+	* determined by WHICH schema it lives in, not by a field-level marker."* A
+	* marker sprinkled across sections also has to borrow a field that already
+	* means something else; borrowing `section.tab` put the literal word
+	* "integration" into an operator-facing tab bar, because `tab` means "how to
+	* GROUP this visually" and cannot also mean "where this lives" (D269
+	* supersedes D268). One declaration, in one place, next to the schema whose
+	* ids it names.
+	*/
+	integrationSettingSections() {
+		return [];
+	}
 	async getGlobalSettings(overlay, cap, nodeId) {
 		const schema = this.globalSettingsSchema(cap);
 		if (!schema) return { sections: [] };
@@ -695,6 +729,55 @@ var BaseAddon = class {
 		} : projected);
 	}
 	/**
+	* The integration-level view of this addon's settings: exactly the sections
+	* named by {@link integrationSettingSections}, hydrated from the SAME store
+	* `getGlobalSettings` reads, and narrowed to cluster-scoped fields.
+	*
+	* Returns `null` when the addon declared nothing — an addon that opts out has
+	* no integration settings surface at all, rather than an empty one that reads
+	* as a failed load.
+	*
+	* Three properties hold BY CONSTRUCTION, which is why they are here in core
+	* and not in whichever UI happens to render this:
+	*
+	*  1. **One key.** The payload is a SUBSET of the global schema, so a field
+	*     shown here is the same field, with the same bare key, that the addon's
+	*     own page shows. There is no integration-specific writer — callers save
+	*     through `updateGlobalSettings` — so a second store key is unreachable,
+	*     not merely discouraged.
+	*  2. **No node scope.** `perNode: true` fields are DROPPED. Their store key
+	*     is `<key>@<nodeId>` and an integration is not a node; whichever node
+	*     such a field silently picked would be a wrong answer for the operator
+	*     who opened the page (D266).
+	*  3. **No silent typo.** A declared id that names no section throws. The
+	*     alternative — skip it — turns a rename into a surface that quietly
+	*     empties, which looks exactly like an addon with nothing to configure.
+	*/
+	async getIntegrationSettings(nodeId) {
+		const declared = this.integrationSettingSections();
+		if (declared.length === 0) return null;
+		const schema = this.globalSettingsSchema();
+		if (!schema) throw new Error(`${this.constructor.name}: integrationSettingSections() names [${declared.join(", ")}] but globalSettingsSchema() returns null.`);
+		const byId = new Map(schema.sections.map((section) => [section.id, section]));
+		const sections = [];
+		for (const id of declared) {
+			const section = byId.get(id);
+			if (!section) throw new Error(`${this.constructor.name}: integrationSettingSections() names unknown section "${id}". Known sections: [${[...byId.keys()].join(", ")}].`);
+			const fields = dropPerNodeFields(section.fields);
+			if (fields.length === 0) continue;
+			sections.push({
+				...section,
+				fields
+			});
+		}
+		if (sections.length === 0) return null;
+		const projected = await this.resolveGlobalStore(nodeId);
+		return hydrateSchema({
+			...schema,
+			sections
+		}, projected);
+	}
+	/**
 	* The raw addon store PROJECTED onto the target node's bare per-node keys:
 	* every `perNode: true` field carries THAT node's scoped value on its bare
 	* key (absent scoped key ⇒ key absent, so the schema `default` wins — no
@@ -998,6 +1081,41 @@ var BaseAddon = class {
 * `hydrateSchema` does. Valueless structural fields (separator/info/…)
 * don't declare `perNode` and are excluded by the `in` narrowing.
 */
+/**
+* The same fields with every `perNode: true` one removed, recursing into layout
+* containers exactly as {@link collectPerNodeFieldKeys} does. A container left
+* with no child is dropped rather than rendered empty.
+*
+* Used by `getIntegrationSettings`: an integration is not a node, so a field
+* whose store key is `<key>@<nodeId>` has no node to belong to there.
+*/
+function dropPerNodeFields(fields) {
+	const kept = [];
+	for (const field of fields) {
+		if (field.type === "group") {
+			const inner = dropPerNodeFields(field.fields);
+			if (inner.length > 0) kept.push({
+				...field,
+				fields: inner
+			});
+			continue;
+		}
+		if (field.type === "sub-tabs") {
+			const tabs = field.tabs.map((tab) => ({
+				...tab,
+				fields: dropPerNodeFields(tab.fields)
+			})).filter((tab) => tab.fields.length > 0);
+			if (tabs.length > 0) kept.push({
+				...field,
+				tabs
+			});
+			continue;
+		}
+		if ("perNode" in field && field.perNode === true) continue;
+		kept.push(field);
+	}
+	return kept;
+}
 function collectPerNodeFieldKeys(fields) {
 	const collected = [];
 	for (const field of fields) {

package/package.json

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