@camstack/types 1.0.6 → 1.1.0

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

@@ -182,8 +182,8 @@ 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;
-    getGlobalSettings(overlay?: Record<string, unknown>, cap?: string): Promise<ConfigUISchemaWithValues>;
-    updateGlobalSettings(patch: Partial<TConfig>): Promise<void>;
+    getGlobalSettings(overlay?: Record<string, unknown>, cap?: string, _nodeId?: string): Promise<ConfigUISchemaWithValues | null>;
+    updateGlobalSettings(patch: Partial<TConfig>, _nodeId?: string): Promise<void>;
     /**
      * If any field in `patch` is marked `requiresRestart` in `schema`,
      * schedule an addon restart for the next tick. Deferred via

package/dist/addon.js

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_sleep = require("./sleep-DnS0eJh_.js");
+const require_sleep = require("./sleep-p-5TJ_dy.js");
 const require_err_msg = require("./err-msg-COpsHMw2.js");
 exports.BaseAddon = require_sleep.BaseAddon;
 exports.DATAPLANE_SECRET_HEADER = require_sleep.DATAPLANE_SECRET_HEADER;

package/dist/addon.mjs

@@ -1,3 +1,3 @@
-import { A as ReadinessTimeoutError, D as parseJsonUnknown, N as scopeKey, O as DATAPLANE_SECRET_HEADER, S as asJsonObject, a as adminUiCapability, at as BaseAddon, ht as DisposerChain, i as deviceOpsCapability, k as ReadinessRegistry, lt as emitReadiness, mt as EventCategory, o as createDeviceProxy, ot as normalizeAddonInitResult, p as expandCapMethods, t as sleep, w as asString, y as DeviceType } from "./sleep-D7JeS58T.mjs";
+import { A as ReadinessTimeoutError, D as parseJsonUnknown, N as scopeKey, O as DATAPLANE_SECRET_HEADER, S as asJsonObject, a as adminUiCapability, at as BaseAddon, ht as DisposerChain, i as deviceOpsCapability, k as ReadinessRegistry, lt as emitReadiness, mt as EventCategory, o as createDeviceProxy, ot as normalizeAddonInitResult, p as expandCapMethods, t as sleep, w as asString, y as DeviceType } from "./sleep-B1dKJAMJ.mjs";
 import { t as errMsg } from "./err-msg-IQTHeDzc.mjs";
 export { BaseAddon, DATAPLANE_SECRET_HEADER, DeviceType, DisposerChain, EventCategory, ReadinessRegistry, ReadinessTimeoutError, adminUiCapability, asJsonObject, asString, createDeviceProxy, deviceOpsCapability, emitReadiness, errMsg, expandCapMethods, normalizeAddonInitResult, parseJsonUnknown, scopeKey, sleep };

package/dist/cap-call-context.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Per-call node pinning for `ctx.api` capability calls.
+ *
+ * A capability call normally resolves to its DEFAULT provider — a `singleton`
+ * cap resolves to the hub, a device-scoped cap to the device's owning node. To
+ * query a SPECIFIC node's provider instead (e.g. a remote agent's own
+ * in-process `platform-probe` hardware, which the hub cannot probe), pin the
+ * call to that node.
+ *
+ * The nodeId rides OUT-OF-BAND in the tRPC call context (NOT in the validated
+ * method args), so capability method signatures stay `nodeId`-free — node
+ * targeting is a property of the CALL, not of the method. The transport lifts
+ * it from `op.context` onto the `CapCallInput.nodeId` field (`ipcParentLink`),
+ * and the hub parent's `onUnownedCall` passes it to the `CapRouteResolver`,
+ * which classifies a pinned agent node as `agent-child-forward`
+ * (`$agent-cap-fwd.forward` → the agent's in-process provider).
+ *
+ * Usage at a call site:
+ *
+ *   await api.platformProbe.getCapabilities.query(undefined, nodePin(nodeId))
+ */
+/** tRPC `op.context` key carrying a per-call node pin. */
+export declare const CAP_NODE_PIN_CONTEXT_KEY = "__camstackNodePin";
+/** The tRPC request-options shape produced by {@link nodePin}. */
+export interface NodePinnedRequestOptions {
+    readonly context: Readonly<Record<string, string>>;
+}
+/**
+ * Build the tRPC request options that pin a single capability call to `nodeId`.
+ * Pass as the second argument to `.query(input, …)` / `.mutate(input, …)`.
+ */
+export declare function nodePin(nodeId: string): NodePinnedRequestOptions;
+/**
+ * Read a per-call node pin out of a tRPC `op.context` (transport side).
+ * Returns the pinned nodeId, or `undefined` when no pin is present.
+ */
+export declare function readNodePin(context: unknown): string | undefined;

package/dist/index.d.ts

@@ -108,6 +108,7 @@ export type * from './interfaces/alerts.js';
 export type * from './interfaces/queryable.js';
 export * from './enums/index.js';
 export * from './constants.js';
+export * from './cap-call-context.js';
 export { parseJsonUnknown, parseJsonObject, parseJsonArray, asJsonObject, asJsonArray, asString, asNumber, asBoolean, } from './utils/json-safe.js';
 export { hfModelUrl } from './utils/hf-url.js';
 export { cosineSimilarity } from './utils/cosine-similarity.js';
@@ -181,3 +182,5 @@ export { RingBuffer } from './utils/ring-buffer.js';
 export { rectsToCells, cellsToRects, type NormRect } from './utils/privacy-grid-raster.js';
 export { sleep, sleepCancellable } from './utils/sleep.js';
 export { bindAddonActions } from './helpers/bind-addon-actions.js';
+export { supportedRuntimes, runtimeDevices, defaultDeviceFor, modelFormatForRuntime, scoreRuntimes, } from './inference/runtime-capabilities.js';
+export type { RuntimeId, DeviceOption } from './inference/runtime-capabilities.js';

package/dist/index.js

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_sleep = require("./sleep-DnS0eJh_.js");
+const require_sleep = require("./sleep-p-5TJ_dy.js");
 const require_err_msg = require("./err-msg-COpsHMw2.js");
 let zod = require("zod");
 //#region src/health/wiring-health.ts
@@ -1136,6 +1136,47 @@ var RUNTIME_DEFAULTS = {
 	"auth.tokenExpiry": "24h"
 };
 //#endregion
+//#region src/cap-call-context.ts
+/**
+* Per-call node pinning for `ctx.api` capability calls.
+*
+* A capability call normally resolves to its DEFAULT provider — a `singleton`
+* cap resolves to the hub, a device-scoped cap to the device's owning node. To
+* query a SPECIFIC node's provider instead (e.g. a remote agent's own
+* in-process `platform-probe` hardware, which the hub cannot probe), pin the
+* call to that node.
+*
+* The nodeId rides OUT-OF-BAND in the tRPC call context (NOT in the validated
+* method args), so capability method signatures stay `nodeId`-free — node
+* targeting is a property of the CALL, not of the method. The transport lifts
+* it from `op.context` onto the `CapCallInput.nodeId` field (`ipcParentLink`),
+* and the hub parent's `onUnownedCall` passes it to the `CapRouteResolver`,
+* which classifies a pinned agent node as `agent-child-forward`
+* (`$agent-cap-fwd.forward` → the agent's in-process provider).
+*
+* Usage at a call site:
+*
+*   await api.platformProbe.getCapabilities.query(undefined, nodePin(nodeId))
+*/
+/** tRPC `op.context` key carrying a per-call node pin. */
+var CAP_NODE_PIN_CONTEXT_KEY = "__camstackNodePin";
+/**
+* Build the tRPC request options that pin a single capability call to `nodeId`.
+* Pass as the second argument to `.query(input, …)` / `.mutate(input, …)`.
+*/
+function nodePin(nodeId) {
+	return { context: { [CAP_NODE_PIN_CONTEXT_KEY]: nodeId } };
+}
+/**
+* Read a per-call node pin out of a tRPC `op.context` (transport side).
+* Returns the pinned nodeId, or `undefined` when no pin is present.
+*/
+function readNodePin(context) {
+	if (context === null || typeof context !== "object") return void 0;
+	const value = Reflect.get(context, CAP_NODE_PIN_CONTEXT_KEY);
+	return typeof value === "string" ? value : void 0;
+}
+//#endregion
 //#region src/utils/hf-url.ts
 function hfModelUrl(repo, path) {
 	return `https://huggingface.co/${repo}/resolve/main/${path}`;
@@ -25051,7 +25092,7 @@ function maskUrlCredentials(rawUrl) {
 			u.password = "";
 			touched = true;
 		}
-		for (const key of [...u.searchParams.keys()]) if (isCredentialParam(key)) {
+		for (const key of Array.from(u.searchParams.keys())) if (isCredentialParam(key)) {
 			u.searchParams.set(key, "***");
 			touched = true;
 		}
@@ -25115,8 +25156,8 @@ var RingBuffer = class {
 */
 function rectsToCells(rects, gridWidth, gridHeight) {
 	const total = gridWidth * gridHeight;
-	if (total <= 0 || rects.length === 0) return new Array(Math.max(0, total)).fill(false);
-	const cells = new Array(total).fill(false);
+	if (total <= 0 || rects.length === 0) return Array.from({ length: Math.max(0, total) }).fill(false);
+	const cells = Array.from({ length: total }).fill(false);
 	for (let row = 0; row < gridHeight; row++) for (let col = 0; col < gridWidth; col++) {
 		const cx = (col + .5) / gridWidth;
 		const cy = (row + .5) / gridHeight;
@@ -25143,7 +25184,7 @@ function rectsToCells(rects, gridWidth, gridHeight) {
 function cellsToRects(cells, gridWidth, gridHeight, maxRegions) {
 	if (gridWidth <= 0 || gridHeight <= 0 || maxRegions <= 0) return [];
 	const expected = gridWidth * gridHeight;
-	const grid = new Array(expected).fill(false);
+	const grid = Array.from({ length: expected }).fill(false);
 	const copyLen = Math.min(cells.length, expected);
 	for (let i = 0; i < copyLen; i++) grid[i] = cells[i] === true;
 	const blocks = [];
@@ -25225,6 +25266,164 @@ function bindAddonActions(api, addonId, catalog) {
 	return out;
 }
 //#endregion
+//#region src/inference/runtime-capabilities.ts
+var AUTO = {
+	value: "auto",
+	label: "Auto"
+};
+var CPU = {
+	value: "cpu",
+	label: "CPU"
+};
+var RUNTIMES = [
+	{
+		id: "onnx",
+		supports: () => true,
+		devices: (hw) => {
+			if (!hw) return [CPU];
+			const out = [CPU];
+			if (hw.gpu?.type === "nvidia") out.push({
+				value: "cuda",
+				label: "CUDA"
+			});
+			if (hw.npu?.type === "apple-ane") out.push({
+				value: "coreml",
+				label: "CoreML EP"
+			});
+			return out;
+		},
+		defaultDevice: "cpu"
+	},
+	{
+		id: "openvino",
+		supports: (hw) => hw?.arch === "x64" && hw.platform !== "darwin" && hw.gpu?.type === "intel",
+		devices: (hw) => {
+			if (!hw) return [AUTO];
+			const out = [AUTO, CPU];
+			if (hw.gpu?.type === "intel") out.push({
+				value: "gpu",
+				label: "GPU"
+			});
+			if (hw.npu?.type === "intel-npu") out.push({
+				value: "npu",
+				label: "NPU"
+			});
+			return out;
+		},
+		defaultDevice: "auto"
+	},
+	{
+		id: "coreml",
+		supports: (hw) => hw?.platform === "darwin",
+		devices: (hw) => {
+			const all = {
+				value: "all",
+				label: "All (ANE + GPU + CPU)"
+			};
+			if (!hw) return [all];
+			const out = [all];
+			if (hw.npu?.type === "apple-ane") out.push({
+				value: "ane",
+				label: "Apple Neural Engine"
+			});
+			out.push({
+				value: "gpu",
+				label: "GPU"
+			}, CPU);
+			return out;
+		},
+		defaultDevice: "all"
+	}
+];
+function def(id) {
+	const d = RUNTIMES.find((r) => r.id === id);
+	if (!d) throw new Error(`Unknown runtime: ${id}`);
+	return d;
+}
+/**
+* Returns the list of supported runtime IDs for given hardware.
+* onnx is always included (universal floor); accelerators added when hw matches.
+*/
+function supportedRuntimes(hw) {
+	return RUNTIMES.filter((r) => r.supports(hw)).map((r) => r.id);
+}
+/**
+* Returns the device options for a given runtime and hardware probe.
+*/
+function runtimeDevices(id, hw) {
+	return def(id).devices(hw);
+}
+/**
+* Returns the default device string for a given runtime.
+* onnx → 'cpu', openvino → 'auto', coreml → 'all'
+*/
+function defaultDeviceFor(id) {
+	return def(id).defaultDevice;
+}
+/**
+* Returns the model format required for a given runtime.
+* Delegates to `formatForRuntime` from runtime-mapping.ts.
+*/
+function modelFormatForRuntime(id) {
+	return formatForRuntime(id);
+}
+/**
+* Scores all applicable inference backends for the given hardware.
+*
+* Rules (hardware-driven only — no Python import probes):
+* - coreml:   score 95, darwin+arm64
+* - cuda:     score 85, nvidia gpu
+* - openvino: score 90 if intel-npu present, else 80 if intel gpu
+* - cpu:      score 50 (universal floor, always included)
+*
+* All hardware-matched entries are `available: true`.
+* Scores are sorted descending; `best` is the first available entry
+* (or last entry as fallback).
+*/
+function scoreRuntimes(hw) {
+	const scores = [];
+	if (hw.platform === "darwin" && hw.arch === "arm64") scores.push({
+		runtime: "python",
+		backend: "coreml",
+		format: "coreml",
+		score: 95,
+		reason: "Apple Neural Engine (Python CoreML)",
+		available: true
+	});
+	if (hw.gpu?.type === "nvidia") scores.push({
+		runtime: "python",
+		backend: "cuda",
+		format: "onnx",
+		score: 85,
+		reason: "NVIDIA CUDA (Python ONNX Runtime)",
+		available: true
+	});
+	if (hw.gpu?.type === "intel") {
+		const score = hw.npu?.type === "intel-npu" ? 90 : 80;
+		scores.push({
+			runtime: "python",
+			backend: "openvino",
+			format: "openvino",
+			score,
+			reason: "Intel OpenVINO",
+			available: true
+		});
+	}
+	scores.push({
+		runtime: "python",
+		backend: "cpu",
+		format: "onnx",
+		score: 50,
+		reason: "CPU (Python ONNX Runtime)",
+		available: true
+	});
+	const sorted = scores.toSorted((a, b) => b.score - a.score);
+	return {
+		scores: sorted,
+		best: sorted.find((s) => s.available) ?? sorted[sorted.length - 1]
+	};
+}
+//#endregion
 exports.ACCESSORY_LABEL = ACCESSORY_LABEL;
 exports.ALL_CAPABILITY_DEFINITIONS = ALL_CAPABILITY_DEFINITIONS;
 exports.APPLE_SA_TO_MACRO = APPLE_SA_TO_MACRO;
@@ -25316,6 +25515,7 @@ exports.CAM_PROFILE_ORDER = require_sleep.CAM_PROFILE_ORDER;
 exports.CAPABILITY_NAMES = CAPABILITY_NAMES;
 exports.CAPABILITY_ROUTER_KEYS = CAPABILITY_ROUTER_KEYS;
 exports.CAP_NAMES_WITH_STATUS = CAP_NAMES_WITH_STATUS;
+exports.CAP_NODE_PIN_CONTEXT_KEY = CAP_NODE_PIN_CONTEXT_KEY;
 exports.CAP_PROVIDER_KIND_MAP = CAP_PROVIDER_KIND_MAP;
 exports.COCO_80_LABELS = COCO_80_LABELS;
 exports.COCO_TO_MACRO = COCO_TO_MACRO;
@@ -25760,6 +25960,7 @@ exports.createSliceHandle = require_sleep.createSliceHandle;
 exports.createSystemProxy = createSystemProxy;
 exports.customAction = customAction;
 exports.decoderCapability = decoderCapability;
+exports.defaultDeviceFor = defaultDeviceFor;
 exports.defineCustomActions = defineCustomActions;
 exports.detectionPipelineCapability = detectionPipelineCapability;
 exports.deviceAdoptionCapability = deviceAdoptionCapability;
@@ -25831,6 +26032,7 @@ exports.meshNetworkCapability = meshNetworkCapability;
 exports.method = require_sleep.method;
 exports.metricsProviderCapability = metricsProviderCapability;
 exports.migrateConfigToBands = migrateConfigToBands;
+exports.modelFormatForRuntime = modelFormatForRuntime;
 exports.motionCapability = motionCapability;
 exports.motionDetectionCapability = motionDetectionCapability;
 exports.motionTriggerCapability = motionTriggerCapability;
@@ -25839,6 +26041,7 @@ exports.mqttBrokerCapability = mqttBrokerCapability;
 exports.nativeObjectDetectionCapability = nativeObjectDetectionCapability;
 exports.networkAccessCapability = networkAccessCapability;
 exports.networkQualityCapability = networkQualityCapability;
+exports.nodePin = nodePin;
 exports.nodesCapability = nodesCapability;
 exports.normalizeAddonInitResult = require_sleep.normalizeAddonInitResult;
 exports.normalizeUnit = normalizeUnit;
@@ -25868,6 +26071,7 @@ exports.privacyMaskCapability = privacyMaskCapability;
 exports.ptzAutotrackCapability = ptzAutotrackCapability;
 exports.ptzCapability = ptzCapability;
 exports.pythonScriptForBackend = pythonScriptForBackend;
+exports.readNodePin = readNodePin;
 exports.readinessKey = require_sleep.readinessKey;
 exports.rebootCapability = rebootCapability;
 exports.recordingCapability = recordingCapability;
@@ -25883,7 +26087,9 @@ exports.resolveModelFormat = resolveModelFormat;
 exports.resolveRunnerId = resolveRunnerId;
 exports.restreamerCapability = restreamerCapability;
 exports.runInferenceStep = runInferenceStep;
+exports.runtimeDevices = runtimeDevices;
 exports.scopeKey = require_sleep.scopeKey;
+exports.scoreRuntimes = scoreRuntimes;
 exports.scriptRunnerCapability = scriptRunnerCapability;
 exports.selectAssignedProfileSlots = require_sleep.selectAssignedProfileSlots;
 exports.setByPath = setByPath;
@@ -25904,6 +26110,7 @@ exports.streamParamsCapability = streamParamsCapability;
 exports.streamPixels = streamPixels;
 exports.streamQualityLabel = streamQualityLabel;
 exports.streamingEngineCapability = streamingEngineCapability;
+exports.supportedRuntimes = supportedRuntimes;
 exports.switchCapability = switchCapability;
 exports.synthesizeSourceInfo = synthesizeSourceInfo;
 exports.systemCapability = systemCapability;

package/dist/index.mjs

@@ -1,4 +1,4 @@
-import { $ as SubscribeFramesInputSchema, A as ReadinessTimeoutError, B as CameraStreamSchema, C as asNumber, D as parseJsonUnknown, E as parseJsonObject, F as BrokerStatusSchema, G as FrameHandleSchema, H as DecodedFrameSchema, I as CAM_PROFILE_ORDER, J as ProfileSlotStatusSchema, K as ProfileRtspEntrySchema, L as CamProfileSchema, M as readinessKey, N as scopeKey, O as DATAPLANE_SECRET_HEADER, P as BrokerStatsSchema, Q as SubscribeAudioChunksResultSchema, R as CamStreamKindSchema, S as asJsonObject, T as parseJsonArray, U as EncodedPacketSchema, V as DecodedAudioChunkSchema, W as FrameHandleFormatSchema, X as StreamSourceSchema, Y as StreamSourceEntrySchema, Z as SubscribeAudioChunksInputSchema, _ as DeviceFeature, a as adminUiCapability, at as BaseAddon, b as asBoolean, c as createMirrorSource, ct as createEvent, d as DEVICE_STATUS_METHOD, dt as WELL_KNOWN_TABS, et as SubscribeFramesResultSchema, f as event, ft as WELL_KNOWN_TAB_MAP, g as ChargingStatus, h as method, ht as DisposerChain, i as deviceOpsCapability, it as selectAssignedProfileSlots, j as emitDownForOwnedCaps, k as ReadinessRegistry, l as createSliceHandle, lt as emitReadiness, m as isDeviceConfigCap, mt as EventCategory, n as sleepCancellable, nt as makeSourceBrokerId, o as createDeviceProxy, ot as normalizeAddonInitResult, p as expandCapMethods, pt as hydrateSchema, q as ProfileSlotSchema, r as RawStateResultSchema, rt as parseProfileBrokerId, s as createLazyTrpcSource, st as createDurableState, t as sleep, tt as makeProfileBrokerId, u as DEVICE_SETTINGS_CONTRIBUTION_METHODS, ut as isEvent, v as DeviceRole, w as asString, x as asJsonArray, y as DeviceType, z as CamStreamResolutionSchema } from "./sleep-D7JeS58T.mjs";
+import { $ as SubscribeFramesInputSchema, A as ReadinessTimeoutError, B as CameraStreamSchema, C as asNumber, D as parseJsonUnknown, E as parseJsonObject, F as BrokerStatusSchema, G as FrameHandleSchema, H as DecodedFrameSchema, I as CAM_PROFILE_ORDER, J as ProfileSlotStatusSchema, K as ProfileRtspEntrySchema, L as CamProfileSchema, M as readinessKey, N as scopeKey, O as DATAPLANE_SECRET_HEADER, P as BrokerStatsSchema, Q as SubscribeAudioChunksResultSchema, R as CamStreamKindSchema, S as asJsonObject, T as parseJsonArray, U as EncodedPacketSchema, V as DecodedAudioChunkSchema, W as FrameHandleFormatSchema, X as StreamSourceSchema, Y as StreamSourceEntrySchema, Z as SubscribeAudioChunksInputSchema, _ as DeviceFeature, a as adminUiCapability, at as BaseAddon, b as asBoolean, c as createMirrorSource, ct as createEvent, d as DEVICE_STATUS_METHOD, dt as WELL_KNOWN_TABS, et as SubscribeFramesResultSchema, f as event, ft as WELL_KNOWN_TAB_MAP, g as ChargingStatus, h as method, ht as DisposerChain, i as deviceOpsCapability, it as selectAssignedProfileSlots, j as emitDownForOwnedCaps, k as ReadinessRegistry, l as createSliceHandle, lt as emitReadiness, m as isDeviceConfigCap, mt as EventCategory, n as sleepCancellable, nt as makeSourceBrokerId, o as createDeviceProxy, ot as normalizeAddonInitResult, p as expandCapMethods, pt as hydrateSchema, q as ProfileSlotSchema, r as RawStateResultSchema, rt as parseProfileBrokerId, s as createLazyTrpcSource, st as createDurableState, t as sleep, tt as makeProfileBrokerId, u as DEVICE_SETTINGS_CONTRIBUTION_METHODS, ut as isEvent, v as DeviceRole, w as asString, x as asJsonArray, y as DeviceType, z as CamStreamResolutionSchema } from "./sleep-B1dKJAMJ.mjs";
 import { t as errMsg } from "./err-msg-IQTHeDzc.mjs";
 import { z } from "zod";
 //#region src/health/wiring-health.ts
@@ -1135,6 +1135,47 @@ var RUNTIME_DEFAULTS = {
 	"auth.tokenExpiry": "24h"
 };
 //#endregion
+//#region src/cap-call-context.ts
+/**
+* Per-call node pinning for `ctx.api` capability calls.
+*
+* A capability call normally resolves to its DEFAULT provider — a `singleton`
+* cap resolves to the hub, a device-scoped cap to the device's owning node. To
+* query a SPECIFIC node's provider instead (e.g. a remote agent's own
+* in-process `platform-probe` hardware, which the hub cannot probe), pin the
+* call to that node.
+*
+* The nodeId rides OUT-OF-BAND in the tRPC call context (NOT in the validated
+* method args), so capability method signatures stay `nodeId`-free — node
+* targeting is a property of the CALL, not of the method. The transport lifts
+* it from `op.context` onto the `CapCallInput.nodeId` field (`ipcParentLink`),
+* and the hub parent's `onUnownedCall` passes it to the `CapRouteResolver`,
+* which classifies a pinned agent node as `agent-child-forward`
+* (`$agent-cap-fwd.forward` → the agent's in-process provider).
+*
+* Usage at a call site:
+*
+*   await api.platformProbe.getCapabilities.query(undefined, nodePin(nodeId))
+*/
+/** tRPC `op.context` key carrying a per-call node pin. */
+var CAP_NODE_PIN_CONTEXT_KEY = "__camstackNodePin";
+/**
+* Build the tRPC request options that pin a single capability call to `nodeId`.
+* Pass as the second argument to `.query(input, …)` / `.mutate(input, …)`.
+*/
+function nodePin(nodeId) {
+	return { context: { [CAP_NODE_PIN_CONTEXT_KEY]: nodeId } };
+}
+/**
+* Read a per-call node pin out of a tRPC `op.context` (transport side).
+* Returns the pinned nodeId, or `undefined` when no pin is present.
+*/
+function readNodePin(context) {
+	if (context === null || typeof context !== "object") return void 0;
+	const value = Reflect.get(context, CAP_NODE_PIN_CONTEXT_KEY);
+	return typeof value === "string" ? value : void 0;
+}
+//#endregion
 //#region src/utils/hf-url.ts
 function hfModelUrl(repo, path) {
 	return `https://huggingface.co/${repo}/resolve/main/${path}`;
@@ -25050,7 +25091,7 @@ function maskUrlCredentials(rawUrl) {
 			u.password = "";
 			touched = true;
 		}
-		for (const key of [...u.searchParams.keys()]) if (isCredentialParam(key)) {
+		for (const key of Array.from(u.searchParams.keys())) if (isCredentialParam(key)) {
 			u.searchParams.set(key, "***");
 			touched = true;
 		}
@@ -25114,8 +25155,8 @@ var RingBuffer = class {
 */
 function rectsToCells(rects, gridWidth, gridHeight) {
 	const total = gridWidth * gridHeight;
-	if (total <= 0 || rects.length === 0) return new Array(Math.max(0, total)).fill(false);
-	const cells = new Array(total).fill(false);
+	if (total <= 0 || rects.length === 0) return Array.from({ length: Math.max(0, total) }).fill(false);
+	const cells = Array.from({ length: total }).fill(false);
 	for (let row = 0; row < gridHeight; row++) for (let col = 0; col < gridWidth; col++) {
 		const cx = (col + .5) / gridWidth;
 		const cy = (row + .5) / gridHeight;
@@ -25142,7 +25183,7 @@ function rectsToCells(rects, gridWidth, gridHeight) {
 function cellsToRects(cells, gridWidth, gridHeight, maxRegions) {
 	if (gridWidth <= 0 || gridHeight <= 0 || maxRegions <= 0) return [];
 	const expected = gridWidth * gridHeight;
-	const grid = new Array(expected).fill(false);
+	const grid = Array.from({ length: expected }).fill(false);
 	const copyLen = Math.min(cells.length, expected);
 	for (let i = 0; i < copyLen; i++) grid[i] = cells[i] === true;
 	const blocks = [];
@@ -25224,4 +25265,162 @@ function bindAddonActions(api, addonId, catalog) {
 	return out;
 }
 //#endregion
-export { ACCESSORY_LABEL, ALL_CAPABILITY_DEFINITIONS, APPLE_SA_TO_MACRO, AUDIO_BACKEND_CHOICES, AUDIO_MACRO_LABELS, AccessoriesStatusSchema, AccessoryKind, AddBrokerInputSchema, AddonAutoUpdateSchema, AddonListItemSchema, AddonPageDeclarationSchema, AddonPageInfoSchema, AdoptInputSchema as AdoptionAdoptInputSchema, AdoptResultSchema as AdoptionAdoptResultSchema, AdoptionFilterSchema, GetCandidateInputSchema as AdoptionGetCandidateInputSchema, ListCandidatesInputSchema as AdoptionListCandidatesInputSchema, ListCandidatesOutputSchema as AdoptionListCandidatesOutputSchema, ReleaseInputSchema as AdoptionReleaseInputSchema, AdoptionStatusSchema, AgentLoadSummarySchema, AirQualitySensorStatusSchema, AlarmArmModeSchema, AlarmPanelStatusSchema, AlarmStateSchema, AlertSchema, AlertSeveritySchema, AlertSourceSchema, AlertStatusSchema, AmbientLightSensorStatusSchema, ApiKeyRecordSchema, ApiKeySummarySchema, ArchiveEntrySchema, ArchiveManifestSchema, AudioAnalysisResultSchema, AudioAnalysisSettingsSchema, AudioChunkInputSchema, AudioClassSummarySchema, AudioClassificationLabelSchema, AudioClassificationResultSchema, AudioCodecInfoSchema, AudioDecodeSessionConfigSchema, AudioEncodeSchema, AudioEncodeSessionConfigSchema, AudioEncodedChunkSchema, AudioEventSchema, AudioLevelSchema, AudioMetricsHistoryPointSchema, AudioMetricsHistorySchema, AudioMetricsSnapshotSchema, AudioPcmChunkSchema, AuthResultSchema, AutoUpdateSettingsSchema, AutomationControlStatusSchema, AvailableIntegrationTypeSchema, BACKEND_TO_FORMAT, BATTERY_DEVICE_PROFILE, BackupDestinationInfoSchema, BackupEntrySchema, BaseAddon, BaseDevice, BaseDeviceProvider, BatteryStatusSchema, BinaryStatusSchema, BoundingBoxSchema, BrightnessStatusSchema, AddInputSchema as BrokerAddInputSchema, BrokerAudioClientSchema, BrokerClientsSchema, BrokerConnectionDetailsSchema, BrokerConsumerAttributionSchema, BrokerConsumerKindSchema, BrokerDecodedClientSchema, BrokerEncodedClientSchema, GetStateInputSchema as BrokerGetStateInputSchema, BrokerInfoSchema, BrokerProviderInfoSchema, PublishInputSchema as BrokerPublishInputSchema, RegistryStatusSchema as BrokerRegistryStatusSchema, BrokerRtspClientSchema, BrokerStatsSchema, BrokerStatusEnum, BrokerStatusSchema, SubscribeInputSchema as BrokerSubscribeInputSchema, SubscribeResultSchema as BrokerSubscribeResultSchema, TestConnectionResultSchema as BrokerTestConnectionResultSchema, UnsubscribeInputSchema as BrokerUnsubscribeInputSchema, CAM_PROFILE_ORDER, CAPABILITY_NAMES, CAPABILITY_ROUTER_KEYS, CAP_NAMES_WITH_STATUS, CAP_PROVIDER_KIND_MAP, COCO_80_LABELS, COCO_TO_MACRO, CamProfileSchema, CamStreamDescriptorSchema, CamStreamKindSchema, CamStreamResolutionSchema, CameraAssignmentStatusSchema, CameraAudioStatusSchema, CameraBrokerProfileSchema, CameraBrokerStatusSchema, CameraCredentialsSchema, CameraCredentialsStatusSchema, CameraDecoderShmSchema, CameraDecoderStatusSchema, CameraDetectionPhaseSchema, CameraDetectionProvisioningSchema, CameraDetectionProvisioningStateSchema, CameraDetectionStatusSchema, CameraMetricsSchema, CameraMetricsWithDeviceIdSchema, CameraMotionStatusSchema, CameraRecordingModeSchema, CameraRecordingStatusSchema, CameraSourceStatusSchema, CameraSourceStreamSchema, CameraStatusSchema, CameraStreamSchema, CandidateQueryFilterSchema, CapScopeSchema, CapabilityBindingsSchema, CarbonMonoxideStatusSchema, ChargingStatus, ClientNetworkStatsSchema, ClimateControlStatusSchema, ClipPlaybackSchema, ClipSchema, ClusterAddonNodeDeploymentSchema, ClusterAddonStatusEntrySchema, CollectionColumnSchema, CollectionIndexSchema, ColorStatusSchema, ConfigEntrySchema, ConfigSectionWithValuesSchema, ConfigTabDeclarationSchema, ConnectivityStatusSchema, ConsumableItemSchema, ConsumablesStatusSchema, ContactStatusSchema, ControlKindSchema, ControlStatusSchema, CoverStateSchema, CoverStatusSchema, CreateApiKeyInputSchema, CreateApiKeyResultSchema, CreateIntegrationInputSchema, CreateScopedTokenInputSchema, CreateScopedTokenResultSchema, CreateUserInputSchema, CustomActionInputSchema, DATAPLANE_SECRET_HEADER, DEFAULT_ADDON_PLACEMENT, DEFAULT_AUDIO_ANALYZER_CONFIG, DEFAULT_DECODER_HWACCEL_CONFIG, DEFAULT_FEATURES, DEFAULT_RETENTION, DEVICE_CAP_NAMES, DEVICE_PROFILES, DEVICE_SETTINGS_CONTRIBUTION_METHODS, DEVICE_STATUS_METHOD, DEVICE_TYPE_INFO, DecodedAudioChunkSchema, DecodedFrameSchema, DecoderAssignmentSchema, DecoderSessionConfigSchema, DecoderStatsSchema, DeleteIntegrationResultSchema, DetectionSourceSchema, DetectorOutputSchema, DeviceConfig, DeviceDiscoveryStatusSchema, ExposeInputSchema as DeviceExportExposeInputSchema, DeviceExportStatusSchema, UnexposeInputSchema as DeviceExportUnexposeInputSchema, DeviceFeature, DeviceInfoSchema, DeviceNetworkStatsSchema, DeviceRole, DeviceRuntimeState, DeviceStatusSchema, DeviceType, DiscoveredChildDeviceSchema, DiscoveredChildStatusSchema, DiscoveredDeviceSchema, DisposerChain, DoorbellPressEventSchema, DoorbellStatusSchema, ElementConfigStore, EmbeddingInfoSchema, EmbeddingResultSchema, EncodeProfileSchema, EncodedPacketSchema, EnrichedWidgetMetadataSchema, EnumSensorDateTimeFormatSchema, EnumSensorStatusSchema, EventCategory, EventEmitterStatusSchema, EventFireSchema, EventItemSchema, EventKindSchema, EventSourceType, ExportSetupFieldSchema, ExportSetupSchema, ExposedDeviceSchema, ExposedResourceSchema, FanControlStatusSchema, FanDirectionSchema, FeatureManifestSchema, FeatureProbeStatusSchema, FloodStatusSchema, FrameHandleFormatSchema, FrameHandleSchema, FrameInputSchema, GasStatusSchema, GetStreamWithCodecInputSchema, GlobalMetricsSchema, HF_BASE_URL, HF_REPO, HWACCEL_OPTIONS, HealthStatusSchema, HistoryPointSchema, HistoryResolutionEnum, HumidifierStatusSchema, HumiditySensorStatusSchema, HvacModeSchema, ImageStatusSchema, InstalledPackageSchema, IntegrationLiteSchema, IntegrationWithStateSchema, IntercomAbilitySchema, IntercomStatusSchema, KNOWN_CAP_NAMES, LawnMowerActivitySchema, LawnMowerControlStatusSchema, LocateSegmentResultSchema, LocationStatSchema, LockControlStatusSchema, LockStateSchema, LogEntrySchema, LogLevelSchema, LogStreamEntrySchema, MACRO_LABELS, METHOD_ACCESS_MAP, MODEL_FORMATS, MaskGridDimsSchema, MaskGridShapeSchema, MaskLineShapeSchema, MaskPointSchema, MaskPolygonShapeSchema, MaskPolygonVerticesSchema, MaskRectShapeSchema, MaskShapeKindSchema, MaskShapeSchema, MediaFileSchema, MediaPlayerRepeatSchema, MediaPlayerStateSchema, MediaPlayerStatusSchema, MeshPeerSchema, MeshStatusSchema, MethodAccessSchema, MotionAnalysisResultSchema, MotionEventSchema, MotionOnMotionChangedDataSchema, MotionRegionSchema, MotionSourceEnum, MotionSourcesSchema, MotionStatusSchema, MotionTriggerRuntimeStateSchema, MotionTriggerStatusSchema, MotionZoneOptionsSchema, MotionZonePatchSchema, MotionZoneRegionSchema, MotionZoneStatusSchema, StatusSchema as MqttBrokerStatusSchema, NativeDetectionSchema, NativeObjectClassEnum, NativeObjectDetectionRuntimeStateSchema, NativeObjectDetectionStatusSchema, NetworkAccessStatusSchema, NetworkAddressSchema, NetworkEndpointSchema, NotificationHistoryEntrySchema, NotificationRuleSchema, NotificationSchema, NotifierStatusSchema, NumericSensorStatusSchema, OauthIntegrationDescriptorSchema, ObjectEventSchema, OrchestratorMetricsSchema, OsdOverlayKindEnum, OsdOverlayPatchSchema, OsdOverlaySchema, OsdPositionEnum, OsdStatusSchema, PIPELINE_FLOW_CAPABILITY_NAMES, PIPELINE_OWNER_CAPABILITY_NAMES, PROVIDER_KIND_CAP_NAMES, PYTHON_SCRIPT, PackageUpdateSchema, PackageVersionInfoSchema, PasskeySummarySchema, PcmSampleFormatSchema, PerScopeBreakdownSchema, PickStreamPreferencesSchema, PickStreamRequirementsSchema, PickedCamStreamSchema, PipelineAssignmentSchema, PipelineDefaultStepSchema, PipelineEngineChoiceSchema, PipelineRunResultBridge, PipelineStepInputSchema, PlaceholderReasonSchema, PolygonPointSchema, PowerMeterStatusSchema, PresenceStatusSchema, PressureSensorStatusSchema, PrivacyMaskOptionsSchema, PrivacyMaskPatchSchema, PrivacyMaskRegionSchema, PrivacyMaskShapeSchema, PrivacyMaskStatusSchema, ProfileRtspEntrySchema, ProfileSlotSchema, ProfileSlotStatusSchema, ProviderStatusSchema, PtzAutotrackRuntimeStateSchema, PtzAutotrackSettingsSchema, PtzAutotrackStatusSchema, PtzAutotrackTargetOptionSchema, PtzMoveCommandSchema, PtzPositionSchema, PtzPresetSchema, PtzStatusSchema, QueryFilterSchema, RECOGNITION_TYPES, RUNTIME_DEFAULTS, RUNTIME_TO_FORMAT, RawStateResultSchema, ReadSegmentBytesResultSchema, ReadinessRegistry, ReadinessTimeoutError, RecordingAvailabilitySchema, RecordingBandModeSchema, RecordingBandSchema, RecordingBandTriggersSchema, RecordingConfigSchema, RecordingDaysSchema, RecordingDeviceUsageSchema, RecordingLocationUsageSchema, RecordingManifestSchema, RecordingModeSchema, RecordingRangeSchema, RecordingRetentionSchema, RecordingRuleSchema, RecordingScheduleSchema, RecordingStatusSchema, RecordingStorageModeSchema, RecordingStorageUsageSchema, RecordingTriggersSchema, RecordingWeekdaySchema, RegisteredStreamSchema, ReportMotionInputSchema, RingBuffer, RtpSourceSchema, RtspRestreamEntrySchema, RunnerCameraConfigSchema, RunnerCameraDeviceUIFields, RunnerLocalLoadSchema, RunnerLocalMetricsSchema, SCOPE_PRESETS, SOURCE_INFO_METADATA_KEY, STREAM_PROFILE_META, STREAM_QUALITY_LABELS, SUB_DETECTION_TYPES, SYSTEM_CAP_NAMES, ScopedTokenSchema, ScopedTokenSummarySchema, ScriptRunnerStatusSchema, SearchResultSchema, SendEmailInputSchema, SendEmailResultSchema, SettingsPatchSchema, SettingsRecordSchema, SettingsSchemaWithValuesSchema, SettingsUpdateResultSchema, ShmRingStatsSchema, SmokeStatusSchema, SmtpStatusSchema, SnapshotImageSchema, SourceInfoSchema, SpatialDetectionSchema, SsoBridgeClaimsSchema, StartEmbeddedInputSchema, AbortUploadInputSchema as StorageAbortUploadInputSchema, BeginDownloadInputSchema as StorageBeginDownloadInputSchema, BeginDownloadResultSchema as StorageBeginDownloadResultSchema, BeginUploadInputSchema as StorageBeginUploadInputSchema, BeginUploadResultSchema as StorageBeginUploadResultSchema, EndDownloadInputSchema as StorageEndDownloadInputSchema, FinalizeUploadInputSchema as StorageFinalizeUploadInputSchema, StorageLocationDeclarationSchema, StorageLocationRefSchema, StorageLocationSchema, StorageLocationTypeSchema, ProviderInfoSchema as StorageProviderInfoSchema, ReadChunkInputSchema as StorageReadChunkInputSchema, TestLocationResultSchema as StorageTestLocationResultSchema, WriteChunkInputSchema as StorageWriteChunkInputSchema, StreamCodecSchema, StreamFormatSchema, StreamInfoSchema, StreamNetworkStatsSchema, StreamParamsOptionsSchema, StreamParamsStatusSchema, StreamProfileConfigSchema, StreamProfileOptionsSchema, StreamProfilePatchSchema, StreamProfileSchema, StreamSourceEntrySchema, StreamSourceSchema, SubscribeAudioChunksInputSchema, SubscribeAudioChunksResultSchema, SubscribeFramesInputSchema, SubscribeFramesResultSchema, SwitchStatusSchema, SystemMetricsSchema, SystemMirror, TIMEZONES, TamperStatusSchema, TankStatusSchema, TemperatureSensorStatusSchema, TestConnectionResultSchema$1 as TestConnectionResultSchema, ToastSchema, TokenScopeSchema, TopologyNodeSchema, TopologyProcessSchema, TopologyServiceSchema, TrackSchema, TrackStateSchema, TrackedDetectionSchema, TurnServerSchema, BrokerInfoSchema$1 as UnifiedBrokerInfoSchema, UpdateIntegrationInputSchema, UpdateStatusSchema, UpdateUserInputSchema, UserRecordSchema, UserSummarySchema, VacuumControlStatusSchema, VacuumStateSchema, ValveStateSchema, ValveStatusSchema, VibrationStatusSchema, VideoEncodeSchema, WELL_KNOWN_TABS, WELL_KNOWN_TAB_MAP, WaterHeaterStatusSchema, WeatherStatusSchema, WebrtcStreamChoiceSchema, WebrtcStreamTargetSchema, WidgetHostEnum, WidgetMetadataSchema, WidgetRemoteSchema, WidgetSizeEnum, YAMNET_TO_MACRO, ZoneKindEnum, ZoneRuleModeEnum, ZoneRuleSchema, ZoneRuleStageEnum, ZoneRulesArraySchema, ZoneSchema, ZoneScopeBreakdownSchema, accessoriesCapability, accessoryStableId, addonPagesCapability, addonPagesSourceCapability, addonRoutesCapability, addonSettingsCapability, addonWidgetsCapability, addonWidgetsSourceCapability, addonsCapability, adminUiCapability, advancedNotifierCapability, airQualitySensorCapability, alarmPanelCapability, alertsCapability, ambientLightSensorCapability, applyTransform, asBoolean, asJsonArray, asJsonObject, asNumber, asString, audioAnalysisCapability, audioAnalyzerCapability, audioCodecCapability, audioMetricsCapability, authProviderCapability, autoAssignProfiles, automationControlCapability, backupCapability, batteryCapability, bestLocationMatch, binaryCapability, bindAddonActions, brightnessCapability, brokerCapability, buildAddonRouteProvider, buildStreamParamsConfigSchema, buttonCapability, cameraCredentialsCapability, cameraPipelineConfigCapability, cameraStreamsCapability, carbonMonoxideCapability, cellsToRects, classifyStream, classifyStreams, climateControlCapability, colorCapability, connectivityCapability, consumablesCapability, contactCapability, controlCapability, cosineSimilarity, coverCapability, createDeviceProxy, createDurableState, createEvent, createLazyTrpcSource, createMirrorSource, createRuntimeStateBridge, createSliceHandle, createSystemProxy, customAction, decoderCapability, defineCustomActions, detectionPipelineCapability, deviceAdoptionCapability, deviceCustomAction, deviceDiscoveryCapability, deviceExportCapability, deviceManagerCapability, deviceMatchesProfile, deviceOpsCapability, deviceProviderCapability, deviceStateCapability, deviceStatusCapability, doorbellCapability, embeddingEncoderCapability, emitDownForOwnedCaps, emitReadiness, encodeProfileFromStreamShape, enumSensorCapability, enumerateSchemaFields, errMsg, evaluateZoneRules, event, eventEmitterCapability, eventsCapability, expandCapMethods, extractSourceInfoFromMetadata, faceGalleryCapability, fanControlCapability, featureProbeCapability, filesystemBrowseCapability, findTimezone, floodCapability, formatForBackend, formatForRuntime, frameworkSwapConfirmSchema, frameworkSwapPackageSchema, gasCapability, getAudioMacroClassIds, getByPath, getCapsByProviderKind, hfModelUrl, humidifierCapability, humiditySensorCapability, hydrateSchema, imageCapability, integrationsCapability, intercomCapability, isAgentOnlyPlacement, isDeployableToAgent, isDeviceConfigCap, isEvent, jobKindSchema, lawnMowerControlCapability, lifecycleJobSchema, lifecycleJobScopeSchema, lifecycleJobStateSchema, lifecycleTaskSchema, localNetworkCapability, locationSimilarity, lockControlCapability, logDestinationCapability, makeProfileBrokerId, makeSourceBrokerId, mapAudioLabelToMacro, maskUrlCredentials, mediaPlayerCapability, mergeSourceInfo, meshNetworkCapability, method, metricsProviderCapability, migrateConfigToBands, motionCapability, motionDetectionCapability, motionTriggerCapability, motionZonesCapability, mqttBrokerCapability, nativeObjectDetectionCapability, networkAccessCapability, networkQualityCapability, nodesCapability, normalizeAddonInitResult, normalizeUnit, notificationOutputCapability, notifierCapability, numericSensorCapability, oauthIntegrationCapability, osdCapability, parseCameraStreamConfig, parseJsonArray, parseJsonObject, parseJsonUnknown, parseProfileBrokerId, parseStreamParamsFormPatch, pendingFrameworkSwapSchema, pickPreferredRtspEntry, pipelineAnalyticsCapability, pipelineExecutorCapability, pipelineOrchestratorCapability, pipelineRunnerCapability, plateGalleryCapability, platformProbeCapability, powerMeterCapability, presenceCapability, pressureSensorCapability, privacyMaskCapability, ptzAutotrackCapability, ptzCapability, pythonScriptForBackend, readinessKey, rebootCapability, recordingCapability, rectsToCells, requiresPython, resolveAddonExecution, resolveAddonGroup, resolveAddonPlacement, resolveAddonRuntime, resolveDetectionRuntime, resolveDeviceProfile, resolveModelFormat, resolveRunnerId, restreamerCapability, runInferenceStep, scopeKey, scriptRunnerCapability, selectAssignedProfileSlots, setByPath, settingsStoreCapability, sleep, sleepCancellable, smokeCapability, smtpProviderCapability, snapshotCapability, snapshotProviderCapability, ssoBridgeCapability, storageCapability, storageEvictableCapability, storageProviderCapability, streamBrokerCapability, streamCatalogCapability, streamParamsCapability, streamPixels, streamQualityLabel, streamingEngineCapability, switchCapability, synthesizeSourceInfo, systemCapability, tamperCapability, taskLogEntrySchema, taskPhaseSchema, taskTargetSchema, temperatureSensorCapability, toDeviceSummary, toStreamSourceEntry, toastCapability, turnProviderCapability, updateCapability, userManagementCapability, userPasskeysCapability, vacuumControlCapability, valveCapability, vibrationCapability, videoclipsCapability, waterHeaterCapability, weatherCapability, webrtcCapability, webrtcClientHintsSchema, webrtcSessionCapability, wiringAddonHealthSchema, wiringHealthSnapshotSchema, wiringNodeHealthSchema, wiringProbeKindSchema, wiringProbeResultSchema, zodEntriesToConfigUI, zoneAnalyticsCapability, zoneRulesCapability, zonesCapability };
+//#region src/inference/runtime-capabilities.ts
+var AUTO = {
+	value: "auto",
+	label: "Auto"
+};
+var CPU = {
+	value: "cpu",
+	label: "CPU"
+};
+var RUNTIMES = [
+	{
+		id: "onnx",
+		supports: () => true,
+		devices: (hw) => {
+			if (!hw) return [CPU];
+			const out = [CPU];
+			if (hw.gpu?.type === "nvidia") out.push({
+				value: "cuda",
+				label: "CUDA"
+			});
+			if (hw.npu?.type === "apple-ane") out.push({
+				value: "coreml",
+				label: "CoreML EP"
+			});
+			return out;
+		},
+		defaultDevice: "cpu"
+	},
+	{
+		id: "openvino",
+		supports: (hw) => hw?.arch === "x64" && hw.platform !== "darwin" && hw.gpu?.type === "intel",
+		devices: (hw) => {
+			if (!hw) return [AUTO];
+			const out = [AUTO, CPU];
+			if (hw.gpu?.type === "intel") out.push({
+				value: "gpu",
+				label: "GPU"
+			});
+			if (hw.npu?.type === "intel-npu") out.push({
+				value: "npu",
+				label: "NPU"
+			});
+			return out;
+		},
+		defaultDevice: "auto"
+	},
+	{
+		id: "coreml",
+		supports: (hw) => hw?.platform === "darwin",
+		devices: (hw) => {
+			const all = {
+				value: "all",
+				label: "All (ANE + GPU + CPU)"
+			};
+			if (!hw) return [all];
+			const out = [all];
+			if (hw.npu?.type === "apple-ane") out.push({
+				value: "ane",
+				label: "Apple Neural Engine"
+			});
+			out.push({
+				value: "gpu",
+				label: "GPU"
+			}, CPU);
+			return out;
+		},
+		defaultDevice: "all"
+	}
+];
+function def(id) {
+	const d = RUNTIMES.find((r) => r.id === id);
+	if (!d) throw new Error(`Unknown runtime: ${id}`);
+	return d;
+}
+/**
+* Returns the list of supported runtime IDs for given hardware.
+* onnx is always included (universal floor); accelerators added when hw matches.
+*/
+function supportedRuntimes(hw) {
+	return RUNTIMES.filter((r) => r.supports(hw)).map((r) => r.id);
+}
+/**
+* Returns the device options for a given runtime and hardware probe.
+*/
+function runtimeDevices(id, hw) {
+	return def(id).devices(hw);
+}
+/**
+* Returns the default device string for a given runtime.
+* onnx → 'cpu', openvino → 'auto', coreml → 'all'
+*/
+function defaultDeviceFor(id) {
+	return def(id).defaultDevice;
+}
+/**
+* Returns the model format required for a given runtime.
+* Delegates to `formatForRuntime` from runtime-mapping.ts.
+*/
+function modelFormatForRuntime(id) {
+	return formatForRuntime(id);
+}
+/**
+* Scores all applicable inference backends for the given hardware.
+*
+* Rules (hardware-driven only — no Python import probes):
+* - coreml:   score 95, darwin+arm64
+* - cuda:     score 85, nvidia gpu
+* - openvino: score 90 if intel-npu present, else 80 if intel gpu
+* - cpu:      score 50 (universal floor, always included)
+*
+* All hardware-matched entries are `available: true`.
+* Scores are sorted descending; `best` is the first available entry
+* (or last entry as fallback).
+*/
+function scoreRuntimes(hw) {
+	const scores = [];
+	if (hw.platform === "darwin" && hw.arch === "arm64") scores.push({
+		runtime: "python",
+		backend: "coreml",
+		format: "coreml",
+		score: 95,
+		reason: "Apple Neural Engine (Python CoreML)",
+		available: true
+	});
+	if (hw.gpu?.type === "nvidia") scores.push({
+		runtime: "python",
+		backend: "cuda",
+		format: "onnx",
+		score: 85,
+		reason: "NVIDIA CUDA (Python ONNX Runtime)",
+		available: true
+	});
+	if (hw.gpu?.type === "intel") {
+		const score = hw.npu?.type === "intel-npu" ? 90 : 80;
+		scores.push({
+			runtime: "python",
+			backend: "openvino",
+			format: "openvino",
+			score,
+			reason: "Intel OpenVINO",
+			available: true
+		});
+	}
+	scores.push({
+		runtime: "python",
+		backend: "cpu",
+		format: "onnx",
+		score: 50,
+		reason: "CPU (Python ONNX Runtime)",
+		available: true
+	});
+	const sorted = scores.toSorted((a, b) => b.score - a.score);
+	return {
+		scores: sorted,
+		best: sorted.find((s) => s.available) ?? sorted[sorted.length - 1]
+	};
+}
+//#endregion
+export { ACCESSORY_LABEL, ALL_CAPABILITY_DEFINITIONS, APPLE_SA_TO_MACRO, AUDIO_BACKEND_CHOICES, AUDIO_MACRO_LABELS, AccessoriesStatusSchema, AccessoryKind, AddBrokerInputSchema, AddonAutoUpdateSchema, AddonListItemSchema, AddonPageDeclarationSchema, AddonPageInfoSchema, AdoptInputSchema as AdoptionAdoptInputSchema, AdoptResultSchema as AdoptionAdoptResultSchema, AdoptionFilterSchema, GetCandidateInputSchema as AdoptionGetCandidateInputSchema, ListCandidatesInputSchema as AdoptionListCandidatesInputSchema, ListCandidatesOutputSchema as AdoptionListCandidatesOutputSchema, ReleaseInputSchema as AdoptionReleaseInputSchema, AdoptionStatusSchema, AgentLoadSummarySchema, AirQualitySensorStatusSchema, AlarmArmModeSchema, AlarmPanelStatusSchema, AlarmStateSchema, AlertSchema, AlertSeveritySchema, AlertSourceSchema, AlertStatusSchema, AmbientLightSensorStatusSchema, ApiKeyRecordSchema, ApiKeySummarySchema, ArchiveEntrySchema, ArchiveManifestSchema, AudioAnalysisResultSchema, AudioAnalysisSettingsSchema, AudioChunkInputSchema, AudioClassSummarySchema, AudioClassificationLabelSchema, AudioClassificationResultSchema, AudioCodecInfoSchema, AudioDecodeSessionConfigSchema, AudioEncodeSchema, AudioEncodeSessionConfigSchema, AudioEncodedChunkSchema, AudioEventSchema, AudioLevelSchema, AudioMetricsHistoryPointSchema, AudioMetricsHistorySchema, AudioMetricsSnapshotSchema, AudioPcmChunkSchema, AuthResultSchema, AutoUpdateSettingsSchema, AutomationControlStatusSchema, AvailableIntegrationTypeSchema, BACKEND_TO_FORMAT, BATTERY_DEVICE_PROFILE, BackupDestinationInfoSchema, BackupEntrySchema, BaseAddon, BaseDevice, BaseDeviceProvider, BatteryStatusSchema, BinaryStatusSchema, BoundingBoxSchema, BrightnessStatusSchema, AddInputSchema as BrokerAddInputSchema, BrokerAudioClientSchema, BrokerClientsSchema, BrokerConnectionDetailsSchema, BrokerConsumerAttributionSchema, BrokerConsumerKindSchema, BrokerDecodedClientSchema, BrokerEncodedClientSchema, GetStateInputSchema as BrokerGetStateInputSchema, BrokerInfoSchema, BrokerProviderInfoSchema, PublishInputSchema as BrokerPublishInputSchema, RegistryStatusSchema as BrokerRegistryStatusSchema, BrokerRtspClientSchema, BrokerStatsSchema, BrokerStatusEnum, BrokerStatusSchema, SubscribeInputSchema as BrokerSubscribeInputSchema, SubscribeResultSchema as BrokerSubscribeResultSchema, TestConnectionResultSchema as BrokerTestConnectionResultSchema, UnsubscribeInputSchema as BrokerUnsubscribeInputSchema, CAM_PROFILE_ORDER, CAPABILITY_NAMES, CAPABILITY_ROUTER_KEYS, CAP_NAMES_WITH_STATUS, CAP_NODE_PIN_CONTEXT_KEY, CAP_PROVIDER_KIND_MAP, COCO_80_LABELS, COCO_TO_MACRO, CamProfileSchema, CamStreamDescriptorSchema, CamStreamKindSchema, CamStreamResolutionSchema, CameraAssignmentStatusSchema, CameraAudioStatusSchema, CameraBrokerProfileSchema, CameraBrokerStatusSchema, CameraCredentialsSchema, CameraCredentialsStatusSchema, CameraDecoderShmSchema, CameraDecoderStatusSchema, CameraDetectionPhaseSchema, CameraDetectionProvisioningSchema, CameraDetectionProvisioningStateSchema, CameraDetectionStatusSchema, CameraMetricsSchema, CameraMetricsWithDeviceIdSchema, CameraMotionStatusSchema, CameraRecordingModeSchema, CameraRecordingStatusSchema, CameraSourceStatusSchema, CameraSourceStreamSchema, CameraStatusSchema, CameraStreamSchema, CandidateQueryFilterSchema, CapScopeSchema, CapabilityBindingsSchema, CarbonMonoxideStatusSchema, ChargingStatus, ClientNetworkStatsSchema, ClimateControlStatusSchema, ClipPlaybackSchema, ClipSchema, ClusterAddonNodeDeploymentSchema, ClusterAddonStatusEntrySchema, CollectionColumnSchema, CollectionIndexSchema, ColorStatusSchema, ConfigEntrySchema, ConfigSectionWithValuesSchema, ConfigTabDeclarationSchema, ConnectivityStatusSchema, ConsumableItemSchema, ConsumablesStatusSchema, ContactStatusSchema, ControlKindSchema, ControlStatusSchema, CoverStateSchema, CoverStatusSchema, CreateApiKeyInputSchema, CreateApiKeyResultSchema, CreateIntegrationInputSchema, CreateScopedTokenInputSchema, CreateScopedTokenResultSchema, CreateUserInputSchema, CustomActionInputSchema, DATAPLANE_SECRET_HEADER, DEFAULT_ADDON_PLACEMENT, DEFAULT_AUDIO_ANALYZER_CONFIG, DEFAULT_DECODER_HWACCEL_CONFIG, DEFAULT_FEATURES, DEFAULT_RETENTION, DEVICE_CAP_NAMES, DEVICE_PROFILES, DEVICE_SETTINGS_CONTRIBUTION_METHODS, DEVICE_STATUS_METHOD, DEVICE_TYPE_INFO, DecodedAudioChunkSchema, DecodedFrameSchema, DecoderAssignmentSchema, DecoderSessionConfigSchema, DecoderStatsSchema, DeleteIntegrationResultSchema, DetectionSourceSchema, DetectorOutputSchema, DeviceConfig, DeviceDiscoveryStatusSchema, ExposeInputSchema as DeviceExportExposeInputSchema, DeviceExportStatusSchema, UnexposeInputSchema as DeviceExportUnexposeInputSchema, DeviceFeature, DeviceInfoSchema, DeviceNetworkStatsSchema, DeviceRole, DeviceRuntimeState, DeviceStatusSchema, DeviceType, DiscoveredChildDeviceSchema, DiscoveredChildStatusSchema, DiscoveredDeviceSchema, DisposerChain, DoorbellPressEventSchema, DoorbellStatusSchema, ElementConfigStore, EmbeddingInfoSchema, EmbeddingResultSchema, EncodeProfileSchema, EncodedPacketSchema, EnrichedWidgetMetadataSchema, EnumSensorDateTimeFormatSchema, EnumSensorStatusSchema, EventCategory, EventEmitterStatusSchema, EventFireSchema, EventItemSchema, EventKindSchema, EventSourceType, ExportSetupFieldSchema, ExportSetupSchema, ExposedDeviceSchema, ExposedResourceSchema, FanControlStatusSchema, FanDirectionSchema, FeatureManifestSchema, FeatureProbeStatusSchema, FloodStatusSchema, FrameHandleFormatSchema, FrameHandleSchema, FrameInputSchema, GasStatusSchema, GetStreamWithCodecInputSchema, GlobalMetricsSchema, HF_BASE_URL, HF_REPO, HWACCEL_OPTIONS, HealthStatusSchema, HistoryPointSchema, HistoryResolutionEnum, HumidifierStatusSchema, HumiditySensorStatusSchema, HvacModeSchema, ImageStatusSchema, InstalledPackageSchema, IntegrationLiteSchema, IntegrationWithStateSchema, IntercomAbilitySchema, IntercomStatusSchema, KNOWN_CAP_NAMES, LawnMowerActivitySchema, LawnMowerControlStatusSchema, LocateSegmentResultSchema, LocationStatSchema, LockControlStatusSchema, LockStateSchema, LogEntrySchema, LogLevelSchema, LogStreamEntrySchema, MACRO_LABELS, METHOD_ACCESS_MAP, MODEL_FORMATS, MaskGridDimsSchema, MaskGridShapeSchema, MaskLineShapeSchema, MaskPointSchema, MaskPolygonShapeSchema, MaskPolygonVerticesSchema, MaskRectShapeSchema, MaskShapeKindSchema, MaskShapeSchema, MediaFileSchema, MediaPlayerRepeatSchema, MediaPlayerStateSchema, MediaPlayerStatusSchema, MeshPeerSchema, MeshStatusSchema, MethodAccessSchema, MotionAnalysisResultSchema, MotionEventSchema, MotionOnMotionChangedDataSchema, MotionRegionSchema, MotionSourceEnum, MotionSourcesSchema, MotionStatusSchema, MotionTriggerRuntimeStateSchema, MotionTriggerStatusSchema, MotionZoneOptionsSchema, MotionZonePatchSchema, MotionZoneRegionSchema, MotionZoneStatusSchema, StatusSchema as MqttBrokerStatusSchema, NativeDetectionSchema, NativeObjectClassEnum, NativeObjectDetectionRuntimeStateSchema, NativeObjectDetectionStatusSchema, NetworkAccessStatusSchema, NetworkAddressSchema, NetworkEndpointSchema, NotificationHistoryEntrySchema, NotificationRuleSchema, NotificationSchema, NotifierStatusSchema, NumericSensorStatusSchema, OauthIntegrationDescriptorSchema, ObjectEventSchema, OrchestratorMetricsSchema, OsdOverlayKindEnum, OsdOverlayPatchSchema, OsdOverlaySchema, OsdPositionEnum, OsdStatusSchema, PIPELINE_FLOW_CAPABILITY_NAMES, PIPELINE_OWNER_CAPABILITY_NAMES, PROVIDER_KIND_CAP_NAMES, PYTHON_SCRIPT, PackageUpdateSchema, PackageVersionInfoSchema, PasskeySummarySchema, PcmSampleFormatSchema, PerScopeBreakdownSchema, PickStreamPreferencesSchema, PickStreamRequirementsSchema, PickedCamStreamSchema, PipelineAssignmentSchema, PipelineDefaultStepSchema, PipelineEngineChoiceSchema, PipelineRunResultBridge, PipelineStepInputSchema, PlaceholderReasonSchema, PolygonPointSchema, PowerMeterStatusSchema, PresenceStatusSchema, PressureSensorStatusSchema, PrivacyMaskOptionsSchema, PrivacyMaskPatchSchema, PrivacyMaskRegionSchema, PrivacyMaskShapeSchema, PrivacyMaskStatusSchema, ProfileRtspEntrySchema, ProfileSlotSchema, ProfileSlotStatusSchema, ProviderStatusSchema, PtzAutotrackRuntimeStateSchema, PtzAutotrackSettingsSchema, PtzAutotrackStatusSchema, PtzAutotrackTargetOptionSchema, PtzMoveCommandSchema, PtzPositionSchema, PtzPresetSchema, PtzStatusSchema, QueryFilterSchema, RECOGNITION_TYPES, RUNTIME_DEFAULTS, RUNTIME_TO_FORMAT, RawStateResultSchema, ReadSegmentBytesResultSchema, ReadinessRegistry, ReadinessTimeoutError, RecordingAvailabilitySchema, RecordingBandModeSchema, RecordingBandSchema, RecordingBandTriggersSchema, RecordingConfigSchema, RecordingDaysSchema, RecordingDeviceUsageSchema, RecordingLocationUsageSchema, RecordingManifestSchema, RecordingModeSchema, RecordingRangeSchema, RecordingRetentionSchema, RecordingRuleSchema, RecordingScheduleSchema, RecordingStatusSchema, RecordingStorageModeSchema, RecordingStorageUsageSchema, RecordingTriggersSchema, RecordingWeekdaySchema, RegisteredStreamSchema, ReportMotionInputSchema, RingBuffer, RtpSourceSchema, RtspRestreamEntrySchema, RunnerCameraConfigSchema, RunnerCameraDeviceUIFields, RunnerLocalLoadSchema, RunnerLocalMetricsSchema, SCOPE_PRESETS, SOURCE_INFO_METADATA_KEY, STREAM_PROFILE_META, STREAM_QUALITY_LABELS, SUB_DETECTION_TYPES, SYSTEM_CAP_NAMES, ScopedTokenSchema, ScopedTokenSummarySchema, ScriptRunnerStatusSchema, SearchResultSchema, SendEmailInputSchema, SendEmailResultSchema, SettingsPatchSchema, SettingsRecordSchema, SettingsSchemaWithValuesSchema, SettingsUpdateResultSchema, ShmRingStatsSchema, SmokeStatusSchema, SmtpStatusSchema, SnapshotImageSchema, SourceInfoSchema, SpatialDetectionSchema, SsoBridgeClaimsSchema, StartEmbeddedInputSchema, AbortUploadInputSchema as StorageAbortUploadInputSchema, BeginDownloadInputSchema as StorageBeginDownloadInputSchema, BeginDownloadResultSchema as StorageBeginDownloadResultSchema, BeginUploadInputSchema as StorageBeginUploadInputSchema, BeginUploadResultSchema as StorageBeginUploadResultSchema, EndDownloadInputSchema as StorageEndDownloadInputSchema, FinalizeUploadInputSchema as StorageFinalizeUploadInputSchema, StorageLocationDeclarationSchema, StorageLocationRefSchema, StorageLocationSchema, StorageLocationTypeSchema, ProviderInfoSchema as StorageProviderInfoSchema, ReadChunkInputSchema as StorageReadChunkInputSchema, TestLocationResultSchema as StorageTestLocationResultSchema, WriteChunkInputSchema as StorageWriteChunkInputSchema, StreamCodecSchema, StreamFormatSchema, StreamInfoSchema, StreamNetworkStatsSchema, StreamParamsOptionsSchema, StreamParamsStatusSchema, StreamProfileConfigSchema, StreamProfileOptionsSchema, StreamProfilePatchSchema, StreamProfileSchema, StreamSourceEntrySchema, StreamSourceSchema, SubscribeAudioChunksInputSchema, SubscribeAudioChunksResultSchema, SubscribeFramesInputSchema, SubscribeFramesResultSchema, SwitchStatusSchema, SystemMetricsSchema, SystemMirror, TIMEZONES, TamperStatusSchema, TankStatusSchema, TemperatureSensorStatusSchema, TestConnectionResultSchema$1 as TestConnectionResultSchema, ToastSchema, TokenScopeSchema, TopologyNodeSchema, TopologyProcessSchema, TopologyServiceSchema, TrackSchema, TrackStateSchema, TrackedDetectionSchema, TurnServerSchema, BrokerInfoSchema$1 as UnifiedBrokerInfoSchema, UpdateIntegrationInputSchema, UpdateStatusSchema, UpdateUserInputSchema, UserRecordSchema, UserSummarySchema, VacuumControlStatusSchema, VacuumStateSchema, ValveStateSchema, ValveStatusSchema, VibrationStatusSchema, VideoEncodeSchema, WELL_KNOWN_TABS, WELL_KNOWN_TAB_MAP, WaterHeaterStatusSchema, WeatherStatusSchema, WebrtcStreamChoiceSchema, WebrtcStreamTargetSchema, WidgetHostEnum, WidgetMetadataSchema, WidgetRemoteSchema, WidgetSizeEnum, YAMNET_TO_MACRO, ZoneKindEnum, ZoneRuleModeEnum, ZoneRuleSchema, ZoneRuleStageEnum, ZoneRulesArraySchema, ZoneSchema, ZoneScopeBreakdownSchema, accessoriesCapability, accessoryStableId, addonPagesCapability, addonPagesSourceCapability, addonRoutesCapability, addonSettingsCapability, addonWidgetsCapability, addonWidgetsSourceCapability, addonsCapability, adminUiCapability, advancedNotifierCapability, airQualitySensorCapability, alarmPanelCapability, alertsCapability, ambientLightSensorCapability, applyTransform, asBoolean, asJsonArray, asJsonObject, asNumber, asString, audioAnalysisCapability, audioAnalyzerCapability, audioCodecCapability, audioMetricsCapability, authProviderCapability, autoAssignProfiles, automationControlCapability, backupCapability, batteryCapability, bestLocationMatch, binaryCapability, bindAddonActions, brightnessCapability, brokerCapability, buildAddonRouteProvider, buildStreamParamsConfigSchema, buttonCapability, cameraCredentialsCapability, cameraPipelineConfigCapability, cameraStreamsCapability, carbonMonoxideCapability, cellsToRects, classifyStream, classifyStreams, climateControlCapability, colorCapability, connectivityCapability, consumablesCapability, contactCapability, controlCapability, cosineSimilarity, coverCapability, createDeviceProxy, createDurableState, createEvent, createLazyTrpcSource, createMirrorSource, createRuntimeStateBridge, createSliceHandle, createSystemProxy, customAction, decoderCapability, defaultDeviceFor, defineCustomActions, detectionPipelineCapability, deviceAdoptionCapability, deviceCustomAction, deviceDiscoveryCapability, deviceExportCapability, deviceManagerCapability, deviceMatchesProfile, deviceOpsCapability, deviceProviderCapability, deviceStateCapability, deviceStatusCapability, doorbellCapability, embeddingEncoderCapability, emitDownForOwnedCaps, emitReadiness, encodeProfileFromStreamShape, enumSensorCapability, enumerateSchemaFields, errMsg, evaluateZoneRules, event, eventEmitterCapability, eventsCapability, expandCapMethods, extractSourceInfoFromMetadata, faceGalleryCapability, fanControlCapability, featureProbeCapability, filesystemBrowseCapability, findTimezone, floodCapability, formatForBackend, formatForRuntime, frameworkSwapConfirmSchema, frameworkSwapPackageSchema, gasCapability, getAudioMacroClassIds, getByPath, getCapsByProviderKind, hfModelUrl, humidifierCapability, humiditySensorCapability, hydrateSchema, imageCapability, integrationsCapability, intercomCapability, isAgentOnlyPlacement, isDeployableToAgent, isDeviceConfigCap, isEvent, jobKindSchema, lawnMowerControlCapability, lifecycleJobSchema, lifecycleJobScopeSchema, lifecycleJobStateSchema, lifecycleTaskSchema, localNetworkCapability, locationSimilarity, lockControlCapability, logDestinationCapability, makeProfileBrokerId, makeSourceBrokerId, mapAudioLabelToMacro, maskUrlCredentials, mediaPlayerCapability, mergeSourceInfo, meshNetworkCapability, method, metricsProviderCapability, migrateConfigToBands, modelFormatForRuntime, motionCapability, motionDetectionCapability, motionTriggerCapability, motionZonesCapability, mqttBrokerCapability, nativeObjectDetectionCapability, networkAccessCapability, networkQualityCapability, nodePin, nodesCapability, normalizeAddonInitResult, normalizeUnit, notificationOutputCapability, notifierCapability, numericSensorCapability, oauthIntegrationCapability, osdCapability, parseCameraStreamConfig, parseJsonArray, parseJsonObject, parseJsonUnknown, parseProfileBrokerId, parseStreamParamsFormPatch, pendingFrameworkSwapSchema, pickPreferredRtspEntry, pipelineAnalyticsCapability, pipelineExecutorCapability, pipelineOrchestratorCapability, pipelineRunnerCapability, plateGalleryCapability, platformProbeCapability, powerMeterCapability, presenceCapability, pressureSensorCapability, privacyMaskCapability, ptzAutotrackCapability, ptzCapability, pythonScriptForBackend, readNodePin, readinessKey, rebootCapability, recordingCapability, rectsToCells, requiresPython, resolveAddonExecution, resolveAddonGroup, resolveAddonPlacement, resolveAddonRuntime, resolveDetectionRuntime, resolveDeviceProfile, resolveModelFormat, resolveRunnerId, restreamerCapability, runInferenceStep, runtimeDevices, scopeKey, scoreRuntimes, scriptRunnerCapability, selectAssignedProfileSlots, setByPath, settingsStoreCapability, sleep, sleepCancellable, smokeCapability, smtpProviderCapability, snapshotCapability, snapshotProviderCapability, ssoBridgeCapability, storageCapability, storageEvictableCapability, storageProviderCapability, streamBrokerCapability, streamCatalogCapability, streamParamsCapability, streamPixels, streamQualityLabel, streamingEngineCapability, supportedRuntimes, switchCapability, synthesizeSourceInfo, systemCapability, tamperCapability, taskLogEntrySchema, taskPhaseSchema, taskTargetSchema, temperatureSensorCapability, toDeviceSummary, toStreamSourceEntry, toastCapability, turnProviderCapability, updateCapability, userManagementCapability, userPasskeysCapability, vacuumControlCapability, valveCapability, vibrationCapability, videoclipsCapability, waterHeaterCapability, weatherCapability, webrtcCapability, webrtcClientHintsSchema, webrtcSessionCapability, wiringAddonHealthSchema, wiringHealthSnapshotSchema, wiringNodeHealthSchema, wiringProbeKindSchema, wiringProbeResultSchema, zodEntriesToConfigUI, zoneAnalyticsCapability, zoneRulesCapability, zonesCapability };

package/dist/inference/runtime-capabilities.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Hardware-driven inference runtime capabilities — SINGLE SOURCE OF TRUTH.
+ *
+ * Pure module: no I/O, no subprocess, no Python import.
+ * Consumed by both `platform-probe` (@camstack/system) and
+ * `detection-pipeline` (@camstack/addon-pipeline).
+ *
+ * Do NOT import from @camstack/system or @camstack/addon-pipeline.
+ */
+import type { ModelFormat } from '../types/models.js';
+import type { HardwareInfo, PlatformScore } from '../interfaces/platform.js';
+export type RuntimeId = 'onnx' | 'openvino' | 'coreml';
+export interface DeviceOption {
+    readonly value: string;
+    readonly label: string;
+}
+/**
+ * Returns the list of supported runtime IDs for given hardware.
+ * onnx is always included (universal floor); accelerators added when hw matches.
+ */
+export declare function supportedRuntimes(hw: HardwareInfo | null): readonly RuntimeId[];
+/**
+ * Returns the device options for a given runtime and hardware probe.
+ */
+export declare function runtimeDevices(id: RuntimeId, hw: HardwareInfo | null): readonly DeviceOption[];
+/**
+ * Returns the default device string for a given runtime.
+ * onnx → 'cpu', openvino → 'auto', coreml → 'all'
+ */
+export declare function defaultDeviceFor(id: RuntimeId): string;
+/**
+ * Returns the model format required for a given runtime.
+ * Delegates to `formatForRuntime` from runtime-mapping.ts.
+ */
+export declare function modelFormatForRuntime(id: RuntimeId): ModelFormat;
+interface ScoreRuntimesResult {
+    readonly scores: readonly PlatformScore[];
+    readonly best: PlatformScore;
+}
+/**
+ * Scores all applicable inference backends for the given hardware.
+ *
+ * Rules (hardware-driven only — no Python import probes):
+ * - coreml:   score 95, darwin+arm64
+ * - cuda:     score 85, nvidia gpu
+ * - openvino: score 90 if intel-npu present, else 80 if intel gpu
+ * - cpu:      score 50 (universal floor, always included)
+ *
+ * All hardware-matched entries are `available: true`.
+ * Scores are sorted descending; `best` is the first available entry
+ * (or last entry as fallback).
+ */
+export declare function scoreRuntimes(hw: HardwareInfo): ScoreRuntimesResult;
+export {};

package/dist/interfaces/addon.d.ts

@@ -706,8 +706,8 @@ export interface ICamstackAddon {
      *  consumed by override-mode UIs (benchmark) so cascade-aware
      *  addons can re-derive dependent options without touching the
      *  persisted store. */
-    getGlobalSettings?(overlay?: Record<string, unknown>, cap?: string): Promise<ConfigUISchemaWithValues>;
-    updateGlobalSettings?(patch: Record<string, unknown>): Promise<void>;
+    getGlobalSettings?(overlay?: Record<string, unknown>, cap?: string, nodeId?: string): Promise<ConfigUISchemaWithValues | null>;
+    updateGlobalSettings?(patch: Record<string, unknown>, nodeId?: string): Promise<void>;
     /** Level 2 — per-device settings (schema + values). Appears in
      *  Device Overrides. */
     getDeviceSettings?(deviceId: number): Promise<ConfigUISchemaWithValues>;

package/dist/{sleep-D7JeS58T.mjs → sleep-B1dKJAMJ.mjs}

@@ -1070,7 +1070,7 @@ var BaseAddon = class {
 	deviceSettingsSchema() {
 		return null;
 	}
-	async getGlobalSettings(overlay, cap) {
+	async getGlobalSettings(overlay, cap, _nodeId) {
 		const schema = this.globalSettingsSchema(cap);
 		if (!schema) return { sections: [] };
 		const raw = await this._ctx?.settings?.readAddonStore() ?? {};
@@ -1079,7 +1079,7 @@ var BaseAddon = class {
 			...overlay
 		} : raw);
 	}
-	async updateGlobalSettings(patch) {
+	async updateGlobalSettings(patch, _nodeId) {
 		await this._ctx?.settings?.writeAddonStore(patch);
 		await this.resolveConfig();
 		await this.onConfigChanged();

package/dist/{sleep-DnS0eJh_.js → sleep-p-5TJ_dy.js}

@@ -1070,7 +1070,7 @@ var BaseAddon = class {
 	deviceSettingsSchema() {
 		return null;
 	}
-	async getGlobalSettings(overlay, cap) {
+	async getGlobalSettings(overlay, cap, _nodeId) {
 		const schema = this.globalSettingsSchema(cap);
 		if (!schema) return { sections: [] };
 		const raw = await this._ctx?.settings?.readAddonStore() ?? {};
@@ -1079,7 +1079,7 @@ var BaseAddon = class {
 			...overlay
 		} : raw);
 	}
-	async updateGlobalSettings(patch) {
+	async updateGlobalSettings(patch, _nodeId) {
 		await this._ctx?.settings?.writeAddonStore(patch);
 		await this.resolveConfig();
 		await this.onConfigChanged();

package/dist/types/models.d.ts

@@ -8,9 +8,17 @@ export interface ModelFormatEntry {
     /** Whether this format is a directory bundle (e.g., .mlpackage) rather than a single file */
     readonly isDirectory?: boolean;
     /**
-     * For directory formats: list of files relative to the directory root.
-     * The downloader fetches each file from `{url}/{file}` and saves to `{modelDir}/{file}`.
-     * If omitted for a directory format, the downloader probes HuggingFace API (slower).
+     * Multi-file format payload.
+     *
+     * - Directory formats (`isDirectory: true`, e.g. `.mlpackage`): files
+     *   relative to the directory root — the downloader fetches each from
+     *   `{url}/{file}` into `{modelDir}/{file}`. If omitted, it probes the
+     *   HuggingFace API (slower).
+     * - Single-file formats (no `isDirectory`, e.g. OpenVINO IR): sibling
+     *   files fetched from the SAME remote directory as `url` and stored flat
+     *   alongside the main file — e.g. `['camstack-yolov9t.bin']` for the IR
+     *   weights next to `camstack-yolov9t.xml`. Keeps the format convention in
+     *   the catalog data instead of the downloader code.
      */
     readonly files?: readonly string[];
     /** Runtime(s) that can use this format. If omitted, inferred from ModelFormat key */

package/package.json

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