@camstack/system 1.2.83 → 1.2.85

package/dist/{manifest-python-deps-DG_LLcZF.js → manifest-python-deps-C0zkl1Ae.js}

@@ -3871,14 +3871,69 @@ function matchesPattern(pattern, category) {
 	if (pattern.endsWith(".*")) return category.startsWith(pattern.slice(0, -2));
 	return pattern === category;
 }
-function extractCategoryPattern(filter) {
-	if (typeof filter === "string") return filter;
+/**
+* EVERY category pattern a filter asks for — the registration key set.
+*
+* `EventFilter.category` has always accepted an array, and until 2026-08-12
+* the delivery path kept only `cat[0]`. Inside a forked runner that was not
+* merely a local filter: `createUdsEventBus` reports its handler-map keys to
+* the parent as this child's forwarding interest, so the categories that never
+* became keys were never forwarded across the process boundary at all. A
+* ten-category subscribe received one category, silently.
+*
+* Duplicates are collapsed so a filter that names the same category twice does
+* not put the entry in one key twice.
+*/
+function extractCategoryPatterns(filter) {
+	if (typeof filter === "string") return [filter];
 	if (filter && typeof filter === "object" && "category" in filter) {
 		const cat = filter.category;
-		if (typeof cat === "string") return cat;
-		if (Array.isArray(cat) && cat.length > 0) return String(cat[0]);
+		if (typeof cat === "string") return [cat];
+		if (Array.isArray(cat) && cat.length > 0) return [...new Set(cat.map((c) => String(c)))];
+	}
+	return ["*"];
+}
+/**
+* Register one handler under every category pattern its filter names, and
+* return the unsubscribe that removes it from all of them.
+*
+* The ONE place a subscriber enters `state.handlers` — both bus
+* implementations (broker and UDS) call it, so "which keys does this
+* subscriber occupy" has a single answer. An emptied key is DELETED rather
+* than left as an empty `Set`: on a child bus the key set is what the parent
+* is told to forward, and an empty set left behind pins the parent to forward
+* a category nobody wants.
+*
+* @param onKeysChanged - Called after the key set may have changed (both on
+*   registration and on unsubscribe), for buses that mirror their key set
+*   somewhere — the UDS child's parent report, the broker's local-interest
+*   surface. Receives the patterns this call touched.
+*/
+function registerSubscriber(state, filter, handler, onKeysChanged) {
+	const patterns = extractCategoryPatterns(filter);
+	const entry = {
+		filter,
+		categoryPattern: patterns[0] ?? "*",
+		handler
+	};
+	for (const pattern of patterns) {
+		const set = state.handlers.get(pattern) ?? /* @__PURE__ */ new Set();
+		set.add(entry);
+		state.handlers.set(pattern, set);
 	}
-	return "*";
+	onKeysChanged?.(patterns, true);
+	let released = false;
+	return () => {
+		if (released) return;
+		released = true;
+		for (const pattern of patterns) {
+			const current = state.handlers.get(pattern);
+			if (current === void 0) continue;
+			current.delete(entry);
+			if (current.size === 0) state.handlers.delete(pattern);
+		}
+		onKeysChanged?.(patterns, false);
+	};
 }
 /**
 * Match an event against the full `EventFilter`. The Map-keyed subscribe path
@@ -3991,10 +4046,13 @@ function deliverShared(state, event) {
 		state.recent.push(event);
 		if (state.recent.length > 1e3) state.recent.splice(0, state.recent.length - MAX_RECENT_EVENTS);
 	}
+	const delivered = /* @__PURE__ */ new Set();
 	for (const [pattern, set] of state.handlers) {
 		if (!matchesPattern(pattern, event.category)) continue;
 		for (const entry of set) {
+			if (delivered.has(entry)) continue;
 			if (!matchesEventFilter(event, entry.filter)) continue;
+			delivered.add(entry);
 			try {
 				entry.handler(event);
 			} catch (err) {}
@@ -4842,13 +4900,14 @@ var LocalChildRegistry = class {
 					method: out.method,
 					args: out.args,
 					...out.deviceId !== void 0 ? { deviceId: out.deviceId } : {},
-					...out.nodeId !== void 0 ? { nodeId: out.nodeId } : {}
+					...out.nodeId !== void 0 ? { nodeId: out.nodeId } : {},
+					...out.native === true ? { native: true } : {}
 				};
 				const pinnedNodeId = out.nodeId ?? extractNodeId(out.args);
 				const pinTargetsThisNode = pinnedNodeId !== void 0 && this.ownNodeId !== void 0 && pinnedNodeId === this.ownNodeId;
 				const aggregated = pinnedNodeId === void 0 && this.isAggregatedCollectionMethod?.(out.capName, out.method) === true;
 				const addonPinned = pinnedNodeId === void 0 && this.isAddonPinnedCall?.(out.capName, out.method, out.args) === true;
-				if ((!aggregated && !addonPinned && (pinnedNodeId === void 0 || pinTargetsThisNode) ? this.resolveChildId(out.capName, out.deviceId) : null) !== null) {
+				if ((!(out.native === true) && !aggregated && !addonPinned && (pinnedNodeId === void 0 || pinTargetsThisNode) ? this.resolveChildId(out.capName, out.deviceId) : null) !== null) {
 					if (!this.egressRoutedCaps.has(out.capName)) {
 						this.egressRoutedCaps.add(out.capName);
 						this.logger?.info("routed child egress over UDS", { capName: out.capName });
@@ -5154,7 +5213,8 @@ var LocalChildClient = class {
 			method: input.method,
 			args: input.args,
 			...input.deviceId !== void 0 ? { deviceId: input.deviceId } : {},
-			...input.nodeId !== void 0 ? { nodeId: input.nodeId } : {}
+			...input.nodeId !== void 0 ? { nodeId: input.nodeId } : {},
+			...input.native === true ? { native: true } : {}
 		};
 		return this.channel.request(msg);
 	}
@@ -5305,23 +5365,7 @@ function createUdsEventBus(client, addonId) {
 			client.emitEvent(enriched);
 		},
 		subscribe(filter, handler) {
-			const pattern = extractCategoryPattern(filter);
-			const entry = {
-				filter,
-				categoryPattern: pattern,
-				handler
-			};
-			const set = state.handlers.get(pattern) ?? /* @__PURE__ */ new Set();
-			set.add(entry);
-			state.handlers.set(pattern, set);
-			reportPatterns();
-			return () => {
-				const current = state.handlers.get(pattern);
-				if (current === void 0) return;
-				current.delete(entry);
-				if (current.size === 0) state.handlers.delete(pattern);
-				reportPatterns();
-			};
+			return registerSubscriber(state, filter, handler, () => reportPatterns());
 		},
 		getRecent(filter, limit) {
 			const filtered = filter ? state.recent.filter((e) => {
@@ -5420,6 +5464,26 @@ var delay = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
 function createParentUnownedCallHandler(deps) {
 	return async (input) => {
 		const deviceId = input.deviceId ?? extractDeviceId(input.args);
+		if (input.native === true) {
+			if (deviceId === void 0) throw new Error(`no native provider for capability "${input.capName}" — the call carried no deviceId`);
+			const provider = deps.resolveNative?.(input.capName, deviceId) ?? null;
+			if (provider !== null) {
+				const fn = provider[input.method];
+				if (typeof fn !== "function") throw new Error(`no native provider for capability "${input.capName}" implementing "${input.method}" on device ${String(deviceId)}`);
+				return await fn(typeof input.args === "object" && input.args !== null && !Array.isArray(input.args) ? {
+					...input.args,
+					deviceId
+				} : { deviceId });
+			}
+			if (deps.forwardToHub !== void 0) return await deps.forwardToHub({
+				capName: input.capName,
+				method: input.method,
+				args: input.args,
+				deviceId,
+				native: true
+			});
+			throw new Error(`no native provider for capability "${input.capName}" on device ${String(deviceId)}`);
+		}
 		const nodeId = deps.isDataNodeIdCap?.(input.capName) === true ? void 0 : input.nodeId ?? extractNodeId(input.args);
 		const pinnedToOtherNode = nodeId !== void 0 && nodeId !== deps.broker.nodeID;
 		if (nodeId === void 0) {
@@ -5525,12 +5589,14 @@ function narrowParams(raw) {
 	if (typeof capName !== "string" || typeof method !== "string") throw new Error("$hub-cap-fwd.forward: invalid params — capName and method are required strings");
 	const deviceId = Reflect.get(raw, "deviceId");
 	const nodeId = Reflect.get(raw, "nodeId");
+	const native = Reflect.get(raw, "native");
 	return {
 		capName,
 		method,
 		args: Reflect.get(raw, "args"),
 		deviceId: typeof deviceId === "number" ? deviceId : void 0,
-		nodeId: typeof nodeId === "string" && nodeId.length > 0 ? nodeId : void 0
+		nodeId: typeof nodeId === "string" && nodeId.length > 0 ? nodeId : void 0,
+		native: native === true ? true : void 0
 	};
 }
 /**
@@ -5546,13 +5612,14 @@ function createHubCapForwardService(onUnownedCall) {
 	return {
 		name: HUB_CAP_FWD_SERVICE,
 		actions: { forward: { handler: async (ctx) => {
-			const { capName, method, args, deviceId, nodeId } = narrowParams(ctx.params);
+			const { capName, method, args, deviceId, nodeId, native } = narrowParams(ctx.params);
 			return onUnownedCall({
 				capName,
 				method,
 				args,
 				...deviceId !== void 0 ? { deviceId } : {},
-				...nodeId !== void 0 ? { nodeId } : {}
+				...nodeId !== void 0 ? { nodeId } : {},
+				...native === true ? { native: true } : {}
 			});
 		} } }
 	};
@@ -6486,18 +6553,7 @@ function localSubscriberPatterns(broker) {
 * Returns an unsubscribe function.
 */
 function subscribePassthrough(broker, handler) {
-	const state = getSharedBusState(broker);
-	const entry = {
-		filter: {},
-		categoryPattern: "*",
-		handler
-	};
-	const set = state.handlers.get("*") ?? /* @__PURE__ */ new Set();
-	set.add(entry);
-	state.handlers.set("*", set);
-	return () => {
-		state.handlers.get("*")?.delete(entry);
-	};
+	return registerSubscriber(getSharedBusState(broker), {}, handler);
 }
 /** Per-broker cross-node inbound counters (delivered / would-suppress). */
 var brokerCrossNodeStats = /* @__PURE__ */ new WeakMap();
@@ -6672,19 +6728,10 @@ function getBrokerEventBus(broker, options) {
 			}
 		},
 		subscribe(filter, handler) {
-			const pattern = extractCategoryPattern(filter);
-			const entry = {
-				filter,
-				categoryPattern: pattern,
-				handler
-			};
-			const set = state.handlers.get(pattern) ?? /* @__PURE__ */ new Set();
-			set.add(entry);
-			state.handlers.set(pattern, set);
-			bumpLocalInterest(broker, pattern);
-			return () => {
-				if (state.handlers.get(pattern)?.delete(entry) === true) dropLocalInterest(broker, pattern);
-			};
+			return registerSubscriber(state, filter, handler, (patterns, added) => {
+				for (const pattern of patterns) if (added) bumpLocalInterest(broker, pattern);
+				else dropLocalInterest(broker, pattern);
+			});
 		},
 		getRecent(filter, limit) {
 			const filtered = filter ? state.recent.filter((e) => {
@@ -7227,6 +7274,29 @@ function kebabToCamel(s) {
 	return s.replace(/-([a-z])/g, (_, c) => c.toUpperCase());
 }
 /**
+* Native-provider proxy for a UDS runner: every cap method dispatches
+* `native: true` over the child→parent channel, carrying `deviceId` both
+* out-of-band (for routing) and inside the args (where the provider reads it).
+*
+* Built from `cap.methods` rather than as a `Proxy` so an unknown method name
+* is a local `undefined` — a wrapper that probes for an optional method sees
+* the same shape it sees on the hub instead of a round-trip that fails.
+*
+* Irreducible bridge: the returned object is assembled by name at runtime, so
+* it is validated structurally against `InferProvider<TCap>` at this one seam
+* (same boundary `buildRemoteNativeProvider` casts at).
+*/
+function buildUdsNativeProvider(callOut, cap, deviceId) {
+	const provider = {};
+	for (const methodName of Object.keys(cap.methods)) provider[methodName] = async (input) => {
+		return await callOut(methodName, typeof input === "object" && input !== null && !Array.isArray(input) ? {
+			...input,
+			deviceId
+		} : { deviceId });
+	};
+	return provider;
+}
+/**
 * Broker-mode entry point — UNCHANGED public signature. The hub
 * (`addon-registry.service.ts`), the agent (`agent-bootstrap.ts`), and
 * every broker-mode test call this with a positional `ServiceBroker`.
@@ -7530,6 +7600,16 @@ async function buildAddonContext(runtime, declaration, dataDir, options) {
 		},
 		getNativeProvider(cap, deviceId) {
 			if (options?.capabilityRegistry) return options.capabilityRegistry.getNativeProvider(cap.name, deviceId);
+			if (runtime.mode === "uds") {
+				const udsClient = runtime.client;
+				return buildUdsNativeProvider((method, args) => udsClient.callOut({
+					capName: cap.name,
+					method,
+					args,
+					deviceId,
+					native: true
+				}), cap, deviceId);
+			}
 			return buildRemoteNativeProvider(api, cap, {
 				nodeId: "hub",
 				bypassWrapper: true

package/dist/{manifest-python-deps-C1DMs1J9.mjs → manifest-python-deps-fWzdEasI.mjs}

@@ -3869,14 +3869,69 @@ function matchesPattern(pattern, category) {
 	if (pattern.endsWith(".*")) return category.startsWith(pattern.slice(0, -2));
 	return pattern === category;
 }
-function extractCategoryPattern(filter) {
-	if (typeof filter === "string") return filter;
+/**
+* EVERY category pattern a filter asks for — the registration key set.
+*
+* `EventFilter.category` has always accepted an array, and until 2026-08-12
+* the delivery path kept only `cat[0]`. Inside a forked runner that was not
+* merely a local filter: `createUdsEventBus` reports its handler-map keys to
+* the parent as this child's forwarding interest, so the categories that never
+* became keys were never forwarded across the process boundary at all. A
+* ten-category subscribe received one category, silently.
+*
+* Duplicates are collapsed so a filter that names the same category twice does
+* not put the entry in one key twice.
+*/
+function extractCategoryPatterns(filter) {
+	if (typeof filter === "string") return [filter];
 	if (filter && typeof filter === "object" && "category" in filter) {
 		const cat = filter.category;
-		if (typeof cat === "string") return cat;
-		if (Array.isArray(cat) && cat.length > 0) return String(cat[0]);
+		if (typeof cat === "string") return [cat];
+		if (Array.isArray(cat) && cat.length > 0) return [...new Set(cat.map((c) => String(c)))];
+	}
+	return ["*"];
+}
+/**
+* Register one handler under every category pattern its filter names, and
+* return the unsubscribe that removes it from all of them.
+*
+* The ONE place a subscriber enters `state.handlers` — both bus
+* implementations (broker and UDS) call it, so "which keys does this
+* subscriber occupy" has a single answer. An emptied key is DELETED rather
+* than left as an empty `Set`: on a child bus the key set is what the parent
+* is told to forward, and an empty set left behind pins the parent to forward
+* a category nobody wants.
+*
+* @param onKeysChanged - Called after the key set may have changed (both on
+*   registration and on unsubscribe), for buses that mirror their key set
+*   somewhere — the UDS child's parent report, the broker's local-interest
+*   surface. Receives the patterns this call touched.
+*/
+function registerSubscriber(state, filter, handler, onKeysChanged) {
+	const patterns = extractCategoryPatterns(filter);
+	const entry = {
+		filter,
+		categoryPattern: patterns[0] ?? "*",
+		handler
+	};
+	for (const pattern of patterns) {
+		const set = state.handlers.get(pattern) ?? /* @__PURE__ */ new Set();
+		set.add(entry);
+		state.handlers.set(pattern, set);
 	}
-	return "*";
+	onKeysChanged?.(patterns, true);
+	let released = false;
+	return () => {
+		if (released) return;
+		released = true;
+		for (const pattern of patterns) {
+			const current = state.handlers.get(pattern);
+			if (current === void 0) continue;
+			current.delete(entry);
+			if (current.size === 0) state.handlers.delete(pattern);
+		}
+		onKeysChanged?.(patterns, false);
+	};
 }
 /**
 * Match an event against the full `EventFilter`. The Map-keyed subscribe path
@@ -3989,10 +4044,13 @@ function deliverShared(state, event) {
 		state.recent.push(event);
 		if (state.recent.length > 1e3) state.recent.splice(0, state.recent.length - MAX_RECENT_EVENTS);
 	}
+	const delivered = /* @__PURE__ */ new Set();
 	for (const [pattern, set] of state.handlers) {
 		if (!matchesPattern(pattern, event.category)) continue;
 		for (const entry of set) {
+			if (delivered.has(entry)) continue;
 			if (!matchesEventFilter(event, entry.filter)) continue;
+			delivered.add(entry);
 			try {
 				entry.handler(event);
 			} catch (err) {}
@@ -4840,13 +4898,14 @@ var LocalChildRegistry = class {
 					method: out.method,
 					args: out.args,
 					...out.deviceId !== void 0 ? { deviceId: out.deviceId } : {},
-					...out.nodeId !== void 0 ? { nodeId: out.nodeId } : {}
+					...out.nodeId !== void 0 ? { nodeId: out.nodeId } : {},
+					...out.native === true ? { native: true } : {}
 				};
 				const pinnedNodeId = out.nodeId ?? extractNodeId(out.args);
 				const pinTargetsThisNode = pinnedNodeId !== void 0 && this.ownNodeId !== void 0 && pinnedNodeId === this.ownNodeId;
 				const aggregated = pinnedNodeId === void 0 && this.isAggregatedCollectionMethod?.(out.capName, out.method) === true;
 				const addonPinned = pinnedNodeId === void 0 && this.isAddonPinnedCall?.(out.capName, out.method, out.args) === true;
-				if ((!aggregated && !addonPinned && (pinnedNodeId === void 0 || pinTargetsThisNode) ? this.resolveChildId(out.capName, out.deviceId) : null) !== null) {
+				if ((!(out.native === true) && !aggregated && !addonPinned && (pinnedNodeId === void 0 || pinTargetsThisNode) ? this.resolveChildId(out.capName, out.deviceId) : null) !== null) {
 					if (!this.egressRoutedCaps.has(out.capName)) {
 						this.egressRoutedCaps.add(out.capName);
 						this.logger?.info("routed child egress over UDS", { capName: out.capName });
@@ -5152,7 +5211,8 @@ var LocalChildClient = class {
 			method: input.method,
 			args: input.args,
 			...input.deviceId !== void 0 ? { deviceId: input.deviceId } : {},
-			...input.nodeId !== void 0 ? { nodeId: input.nodeId } : {}
+			...input.nodeId !== void 0 ? { nodeId: input.nodeId } : {},
+			...input.native === true ? { native: true } : {}
 		};
 		return this.channel.request(msg);
 	}
@@ -5303,23 +5363,7 @@ function createUdsEventBus(client, addonId) {
 			client.emitEvent(enriched);
 		},
 		subscribe(filter, handler) {
-			const pattern = extractCategoryPattern(filter);
-			const entry = {
-				filter,
-				categoryPattern: pattern,
-				handler
-			};
-			const set = state.handlers.get(pattern) ?? /* @__PURE__ */ new Set();
-			set.add(entry);
-			state.handlers.set(pattern, set);
-			reportPatterns();
-			return () => {
-				const current = state.handlers.get(pattern);
-				if (current === void 0) return;
-				current.delete(entry);
-				if (current.size === 0) state.handlers.delete(pattern);
-				reportPatterns();
-			};
+			return registerSubscriber(state, filter, handler, () => reportPatterns());
 		},
 		getRecent(filter, limit) {
 			const filtered = filter ? state.recent.filter((e) => {
@@ -5418,6 +5462,26 @@ var delay = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
 function createParentUnownedCallHandler(deps) {
 	return async (input) => {
 		const deviceId = input.deviceId ?? extractDeviceId(input.args);
+		if (input.native === true) {
+			if (deviceId === void 0) throw new Error(`no native provider for capability "${input.capName}" — the call carried no deviceId`);
+			const provider = deps.resolveNative?.(input.capName, deviceId) ?? null;
+			if (provider !== null) {
+				const fn = provider[input.method];
+				if (typeof fn !== "function") throw new Error(`no native provider for capability "${input.capName}" implementing "${input.method}" on device ${String(deviceId)}`);
+				return await fn(typeof input.args === "object" && input.args !== null && !Array.isArray(input.args) ? {
+					...input.args,
+					deviceId
+				} : { deviceId });
+			}
+			if (deps.forwardToHub !== void 0) return await deps.forwardToHub({
+				capName: input.capName,
+				method: input.method,
+				args: input.args,
+				deviceId,
+				native: true
+			});
+			throw new Error(`no native provider for capability "${input.capName}" on device ${String(deviceId)}`);
+		}
 		const nodeId = deps.isDataNodeIdCap?.(input.capName) === true ? void 0 : input.nodeId ?? extractNodeId(input.args);
 		const pinnedToOtherNode = nodeId !== void 0 && nodeId !== deps.broker.nodeID;
 		if (nodeId === void 0) {
@@ -5523,12 +5587,14 @@ function narrowParams(raw) {
 	if (typeof capName !== "string" || typeof method !== "string") throw new Error("$hub-cap-fwd.forward: invalid params — capName and method are required strings");
 	const deviceId = Reflect.get(raw, "deviceId");
 	const nodeId = Reflect.get(raw, "nodeId");
+	const native = Reflect.get(raw, "native");
 	return {
 		capName,
 		method,
 		args: Reflect.get(raw, "args"),
 		deviceId: typeof deviceId === "number" ? deviceId : void 0,
-		nodeId: typeof nodeId === "string" && nodeId.length > 0 ? nodeId : void 0
+		nodeId: typeof nodeId === "string" && nodeId.length > 0 ? nodeId : void 0,
+		native: native === true ? true : void 0
 	};
 }
 /**
@@ -5544,13 +5610,14 @@ function createHubCapForwardService(onUnownedCall) {
 	return {
 		name: HUB_CAP_FWD_SERVICE,
 		actions: { forward: { handler: async (ctx) => {
-			const { capName, method, args, deviceId, nodeId } = narrowParams(ctx.params);
+			const { capName, method, args, deviceId, nodeId, native } = narrowParams(ctx.params);
 			return onUnownedCall({
 				capName,
 				method,
 				args,
 				...deviceId !== void 0 ? { deviceId } : {},
-				...nodeId !== void 0 ? { nodeId } : {}
+				...nodeId !== void 0 ? { nodeId } : {},
+				...native === true ? { native: true } : {}
 			});
 		} } }
 	};
@@ -6484,18 +6551,7 @@ function localSubscriberPatterns(broker) {
 * Returns an unsubscribe function.
 */
 function subscribePassthrough(broker, handler) {
-	const state = getSharedBusState(broker);
-	const entry = {
-		filter: {},
-		categoryPattern: "*",
-		handler
-	};
-	const set = state.handlers.get("*") ?? /* @__PURE__ */ new Set();
-	set.add(entry);
-	state.handlers.set("*", set);
-	return () => {
-		state.handlers.get("*")?.delete(entry);
-	};
+	return registerSubscriber(getSharedBusState(broker), {}, handler);
 }
 /** Per-broker cross-node inbound counters (delivered / would-suppress). */
 var brokerCrossNodeStats = /* @__PURE__ */ new WeakMap();
@@ -6670,19 +6726,10 @@ function getBrokerEventBus(broker, options) {
 			}
 		},
 		subscribe(filter, handler) {
-			const pattern = extractCategoryPattern(filter);
-			const entry = {
-				filter,
-				categoryPattern: pattern,
-				handler
-			};
-			const set = state.handlers.get(pattern) ?? /* @__PURE__ */ new Set();
-			set.add(entry);
-			state.handlers.set(pattern, set);
-			bumpLocalInterest(broker, pattern);
-			return () => {
-				if (state.handlers.get(pattern)?.delete(entry) === true) dropLocalInterest(broker, pattern);
-			};
+			return registerSubscriber(state, filter, handler, (patterns, added) => {
+				for (const pattern of patterns) if (added) bumpLocalInterest(broker, pattern);
+				else dropLocalInterest(broker, pattern);
+			});
 		},
 		getRecent(filter, limit) {
 			const filtered = filter ? state.recent.filter((e) => {
@@ -7225,6 +7272,29 @@ function kebabToCamel(s) {
 	return s.replace(/-([a-z])/g, (_, c) => c.toUpperCase());
 }
 /**
+* Native-provider proxy for a UDS runner: every cap method dispatches
+* `native: true` over the child→parent channel, carrying `deviceId` both
+* out-of-band (for routing) and inside the args (where the provider reads it).
+*
+* Built from `cap.methods` rather than as a `Proxy` so an unknown method name
+* is a local `undefined` — a wrapper that probes for an optional method sees
+* the same shape it sees on the hub instead of a round-trip that fails.
+*
+* Irreducible bridge: the returned object is assembled by name at runtime, so
+* it is validated structurally against `InferProvider<TCap>` at this one seam
+* (same boundary `buildRemoteNativeProvider` casts at).
+*/
+function buildUdsNativeProvider(callOut, cap, deviceId) {
+	const provider = {};
+	for (const methodName of Object.keys(cap.methods)) provider[methodName] = async (input) => {
+		return await callOut(methodName, typeof input === "object" && input !== null && !Array.isArray(input) ? {
+			...input,
+			deviceId
+		} : { deviceId });
+	};
+	return provider;
+}
+/**
 * Broker-mode entry point — UNCHANGED public signature. The hub
 * (`addon-registry.service.ts`), the agent (`agent-bootstrap.ts`), and
 * every broker-mode test call this with a positional `ServiceBroker`.
@@ -7528,6 +7598,16 @@ async function buildAddonContext(runtime, declaration, dataDir, options) {
 		},
 		getNativeProvider(cap, deviceId) {
 			if (options?.capabilityRegistry) return options.capabilityRegistry.getNativeProvider(cap.name, deviceId);
+			if (runtime.mode === "uds") {
+				const udsClient = runtime.client;
+				return buildUdsNativeProvider((method, args) => udsClient.callOut({
+					capName: cap.name,
+					method,
+					args,
+					deviceId,
+					native: true
+				}), cap, deviceId);
+			}
 			return buildRemoteNativeProvider(api, cap, {
 				nodeId: "hub",
 				bypassWrapper: true

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@camstack/system",
-  "version": "1.2.83",
+  "version": "1.2.85",
   "description": "Core addon for CamStack — builtins, pipeline, process management, auth, logging, events",
   "keywords": [
     "camstack",
@@ -168,7 +168,12 @@
         "id": "snapshot",
         "category": "system",
         "name": "Snapshot",
+        "description": "Owns every camera's latest frame: the capture ladder (vendor native → ffmpeg keyframe grab off the stream-broker restream), the sharp resize, the courtesy frame for a camera that cannot answer, and the two HTTP planes the clients actually fetch bytes from. Runs in its OWN process (`execution.isolate`) — capture, transcode and byte caches do not belong on the event loop that serves the API.",
         "entry": "./dist/builtins/snapshot/index.js",
+        "execution": {
+          "isolate": true,
+          "heapProfile": "heavy"
+        },
         "capabilities": [
           {
             "name": "snapshot"