@camstack/system 1.1.49 → 1.1.51

package/dist/{dist-BDV1WKRg.js → dist-C3uHEBtP.js}

@@ -1,5 +1,5 @@
 let zod = require("zod");
-//#region ../types/dist/sleep-DkhOVOjW.mjs
+//#region ../types/dist/event-category-CFZs3jI4.mjs
 var EventCategory = /* @__PURE__ */ function(EventCategory) {
 	EventCategory["SystemBoot"] = "system.boot";
 	EventCategory["SystemAddonsReady"] = "system.addons-ready";
@@ -430,6 +430,14 @@ var EventCategory = /* @__PURE__ */ function(EventCategory) {
 	EventCategory["PipelineAnalyticsDetectionEvent"] = "pipeline-analytics.detection-event";
 	EventCategory["PipelineAnalyticsFrameTracked"] = "pipeline-analytics.frame-tracked";
 	/**
+	* Fired by `addon-post-analysis` when a parked (stationary) object appears
+	* (a track was promoted to a stationary-registry entry) or departs (the
+	* object moved / was removed). Telemetry (D8): lossy, drives a UI refresh of
+	* the dedicated "Stationary" section — never the live event feed. Payload:
+	* `{ deviceId, entryId, className, phase:'appeared'|'departed', timestamp }`.
+	*/
+	EventCategory["PipelineAnalyticsStationaryChanged"] = "pipeline-analytics.stationary-changed";
+	/**
 	* Fired by `addon-post-analysis` whenever a gallery face row changes:
 	* `kind:'buffered'` a new detected face was persisted, `'assigned'` /
 	* `'unassigned'` its identity link changed, `'deleted'` the row was
@@ -2980,6 +2988,15 @@ var ModelCatalogEntrySchema = zod.z.object({
 		width: zod.z.number(),
 		height: zod.z.number()
 	}),
+	/**
+	* Channel count of the model input tensor. Omit ⇒ 3 (RGB), the default for
+	* every detector / classifier / embedder. Set to 1 for a grayscale CTC text
+	* recognizer (EasyOCR VGG plate-OCR: input `[N,1,H,W]`) so the preprocess
+	* feeds a single-channel, EasyOCR-normalized tensor instead of the default
+	* 3-channel RGB one. Threaded through `PoolModelConfig.inputChannels` to the
+	* Python inference pool.
+	*/
+	inputChannels: zod.z.number().int().positive().optional(),
 	labels: zod.z.array(LabelDefinitionSchema).readonly(),
 	inputLayout: zod.z.enum(["nchw", "nhwc"]).optional(),
 	inputNormalization: zod.z.enum([
@@ -2989,6 +3006,16 @@ var ModelCatalogEntrySchema = zod.z.object({
 	]).optional(),
 	preprocessMode: zod.z.enum(["letterbox", "resize"]).optional(),
 	/**
+	* Per-MODEL postprocessor override. Absent ⇒ the step's own
+	* `StepDefinition.postprocessor` applies (the normal case — every model in a
+	* step shares its decode). Set it when a step hosts models with DIFFERENT raw
+	* output layouts under one slot: e.g. object-detection is `'yolo'` by default,
+	* but a Coral SSD MobileNet build emits the `TFLite_Detection_PostProcess`
+	* 4-tensor layout and needs `'ssd'`. Threaded into `PoolModelConfig.postprocessor`
+	* by the engine factory (`modelEntry.postprocessor ?? def.postprocessor`).
+	*/
+	postprocessor: zod.z.custom().optional(),
+	/**
 	* When true, the executor produces a landmark-aligned crop (similarity warp
 	* onto the canonical template) before this step runs, instead of a plain
 	* axis-aligned bbox crop. Required for face-recognition embedders (ArcFace):
@@ -7980,7 +8007,8 @@ var EngineProvisioningSchema = zod.z.object({
 	runtimeId: zod.z.enum([
 		"onnx",
 		"openvino",
-		"coreml"
+		"coreml",
+		"edgetpu"
 	]).nullable(),
 	device: zod.z.string().nullable(),
 	state: zod.z.enum([
@@ -10806,6 +10834,36 @@ var ZoneScopeBreakdownSchema = PerScopeBreakdownSchema.extend({
 	*  with the per-track detail panel and live overlay. */
 	trackIds: zod.z.array(zod.z.string()).readonly()
 });
+/**
+* A parked ("stationary") object surfaced alongside occupancy — an object that
+* settled and stopped moving. It is NO LONGER a tracked object (the tracker was
+* told to forget it so it stops re-spawning tracks/events), but it IS still
+* physically present, so it keeps counting toward `frame` occupancy and is
+* listed here so the UI can show it in a dedicated "Stationary" section instead
+* of flooding the live event feed.
+*/
+var StationaryObjectSchema = zod.z.object({
+	id: zod.z.string(),
+	className: zod.z.string(),
+	bbox: zod.z.object({
+		x: zod.z.number(),
+		y: zod.z.number(),
+		w: zod.z.number(),
+		h: zod.z.number()
+	}),
+	frameWidth: zod.z.number().int().nonnegative(),
+	frameHeight: zod.z.number().int().nonnegative(),
+	/** When the source track was first seen. */
+	firstSeenAt: zod.z.number().int(),
+	/** When the object was recognised as parked (promotion time). */
+	becameStationaryAt: zod.z.number().int(),
+	/** Last frame a detection confirmed the object is still there. */
+	lastConfirmedAt: zod.z.number().int(),
+	/** Enrichment label carried from the source track (identity / plate). */
+	label: zod.z.string().optional(),
+	/** Native-resolution key-frame media key for the parked object's best image. */
+	keyFrameMediaKey: zod.z.string().optional()
+});
 var CameraOccupancySnapshotSchema = zod.z.object({
 	/** Frame timestamp of the inference result that produced this snapshot. */
 	ts: zod.z.number().int(),
@@ -10814,10 +10872,15 @@ var CameraOccupancySnapshotSchema = zod.z.object({
 	frameHeight: zod.z.number().int().nonnegative(),
 	/** Per-zone breakdown — one entry per defined zone (user + onboard). */
 	zones: zod.z.array(ZoneScopeBreakdownSchema).readonly(),
-	/** Frame-wide aggregate (everywhere, regardless of zone membership). */
+	/** Frame-wide aggregate (everywhere, regardless of zone membership).
+	*  INCLUDES currently-confirmed stationary objects (they are still present). */
 	frame: PerScopeBreakdownSchema,
 	/** Detections that landed outside every zone. Empty when no zones defined. */
-	unzoned: PerScopeBreakdownSchema
+	unzoned: PerScopeBreakdownSchema,
+	/** Parked objects on this camera (additive — absent on legacy snapshots).
+	*  Surfaced separately so the UI shows them in a dedicated section rather
+	*  than as repeated tracks/events. */
+	stationaryObjects: zod.z.array(StationaryObjectSchema).readonly().optional()
 });
 /**
 * Time-series resolution. The history methods return one bucket per
@@ -12801,6 +12864,64 @@ function looseSchema(schema) {
 	const loose = schema.loose;
 	return typeof loose === "function" ? loose.call(schema) : schema;
 }
+/**
+* Derive a COLLECTION-cap routing `addonId` from a NON-array mutation input
+* when the caller did NOT supply the top-level `{ addonId }` selector.
+*
+* Background: a `scope:'system', mode:'collection'` cap fans its ARRAY methods
+* (`listTargets`, `listTargetKinds`, …) across every provider, but routes each
+* single-object method (`send` / CRUD) to ONE provider. The runtime router
+* strips a TOP-LEVEL `addonId` selector and routes it via
+* `getProviderByAddonId`; absent that selector it falls through to the FIRST
+* registered provider — which misroutes (or hard-crashes on a partial provider)
+* when the target is owned by a DIFFERENT provider. See
+* `notification-output.cap.ts` (`Target.addonId` / `TargetKind.addonId` are
+* "stamped by each provider so the concat-fanned catalog stays routable").
+*
+* That routing `addonId` is ALREADY carried inside the mutation payload the
+* caller sends — e.g. `upsertTarget({ target: { …, addonId } })`. This helper
+* recovers it: it scans the input's DIRECT child object properties (bounded to
+* one level, first match wins) for a string `addonId`. Mirrors the child-side
+* `extractArgsAddonId` fallback in `child-cap-dispatch.ts`, which reads a
+* top-level `addonId` off the raw args; this covers the one-level-nested case
+* the top-level scan misses.
+*
+* Only used for non-array collection methods (array fan-out is never rerouted),
+* so it can never collapse a catalog aggregation onto a single provider. `null`
+* / non-object inputs yield `undefined` (fall back to the first provider,
+* preserving single-provider and id-only-payload back-compat).
+*/
+function extractNestedAddonId(input) {
+	if (input === null || typeof input !== "object") return void 0;
+	for (const value of Object.values(input)) if (value !== null && typeof value === "object") {
+		const nested = value.addonId;
+		if (typeof nested === "string") return nested;
+	}
+}
+/**
+* True when an OBJECT input schema declares a top-level `addonId` field.
+*
+* Such a cap method routes explicitly via the top-level `{ addonId }` selector
+* (the `llm.generate` / `deleteProfile` posture). The runtime router therefore
+* MUST NOT also fall back to {@link extractNestedAddonId} for it — that would
+* let an incidental nested `addonId` (e.g. a key inside a free-form `jsonSchema`
+* record) hijack routing. Nested recovery is reserved for methods whose input
+* carries NO top-level selector but embeds the owning `addonId` inside a domain
+* entity (`upsertTarget({ target: { addonId } })`, `upsertProfile({ profile })`).
+*
+* Accepts both Zod 4 (`.shape` / `_def.shape`) and legacy shapes; returns false
+* for non-object schemas.
+*/
+function objectInputDeclaresAddonId(schema) {
+	if (schema === null || typeof schema !== "object" && typeof schema !== "function") return false;
+	const direct = schema.shape;
+	const shape = direct !== void 0 && direct !== null ? direct : resolveDefShape(schema._def?.shape);
+	return shape !== void 0 && shape !== null && typeof shape === "object" && Object.prototype.hasOwnProperty.call(shape, "addonId");
+}
+/** `_def.shape` may be a thunk (Zod defers object-shape evaluation) or a plain record. */
+function resolveDefShape(defShape) {
+	return typeof defShape === "function" ? defShape() : defShape;
+}
 /** Auth level → base-procedure key. `superAdmin` collapses to `admin`. */
 function procedureAuthKey(auth) {
 	if (auth === "public") return "public";
@@ -15531,6 +15652,22 @@ var TrackSnapshotSchema = zod.z.object({
 	/** MediaStore key; resolve via `getTrackMedia({ trackId })`. */
 	mediaKey: zod.z.string()
 });
+/**
+* One audio-classification label heard on the track's camera while the
+* track was alive, aggregated per label. An "episode" is one persisted
+* audio event (the confident-classification path: score ≥ the device's
+* `classificationMinScore`, class-change-or-heartbeat coalesced) — NOT
+* one 32 ms inference chunk, so counts stay human-scaled.
+*/
+var TrackAudioLabelSchema = zod.z.object({
+	label: zod.z.string(),
+	/** Highest classification score observed across the label's episodes. */
+	peakScore: zod.z.number(),
+	/** Number of coalesced audio-event episodes carrying this label. */
+	count: zod.z.number(),
+	firstAt: zod.z.number(),
+	lastAt: zod.z.number()
+});
 var TrackSchema = zod.z.object({
 	trackId: zod.z.string(),
 	deviceId: zod.z.number(),
@@ -15562,7 +15699,11 @@ var TrackSchema = zod.z.object({
 	bestEventId: zod.z.string().optional(),
 	/** Tag of the importance sub-signal that dominated the score
 	*  (identity|dwell|proximity|class|confidence|travel|zone). */
-	importanceReason: zod.z.string().optional()
+	importanceReason: zod.z.string().optional(),
+	/** Audio-classification labels heard on the camera during the track's
+	*  life (score ≥ device `classificationMinScore`), aggregated per label.
+	*  Absent on legacy rows / tracks with no confident audio. */
+	audioLabels: zod.z.array(TrackAudioLabelSchema).readonly().optional()
 });
 var BaseEventFields = {
 	id: zod.z.string(),
@@ -17811,7 +17952,15 @@ var webrtcSessionCapability = {
 			*/
 			disableIpv6: zod.z.boolean().optional(),
 			/** Subscriber attribution. See `createSession` for the contract. */
-			consumerAttribution: BrokerConsumerAttributionSchema.optional()
+			consumerAttribution: BrokerConsumerAttributionSchema.optional(),
+			/**
+			* Client-side stream hints (viewport, downlink) — same contract as
+			* `createSession.hints`. Client-offer viewers (the RN viewer's
+			* `WebrtcLiveSession`) negotiate via `handleOffer`, so without this
+			* field their hints were silently stripped by the schema and the
+			* adaptive ladder started blind on the client's display size.
+			*/
+			hints: webrtcClientHintsSchema.optional()
 		}), zod.z.object({
 			sessionId: zod.z.string(),
 			sdpAnswer: zod.z.string()
@@ -20139,6 +20288,10 @@ var GpuInfoSchema = zod.z.object({
 	memoryMB: zod.z.number().optional()
 });
 var NpuInfoSchema = zod.z.object({ type: zod.z.enum(["apple-ane", "intel-npu"]) });
+var CoralInfoSchema = zod.z.object({
+	type: zod.z.literal("coral-edgetpu"),
+	bus: zod.z.string().optional()
+});
 var HardwareInfoSchema = zod.z.object({
 	platform: HardwarePlatformSchema,
 	arch: HardwareArchSchema,
@@ -20147,7 +20300,8 @@ var HardwareInfoSchema = zod.z.object({
 	totalRAM_MB: zod.z.number(),
 	availableRAM_MB: zod.z.number(),
 	gpu: GpuInfoSchema.nullable(),
-	npu: NpuInfoSchema.nullable()
+	npu: NpuInfoSchema.nullable(),
+	coral: CoralInfoSchema.nullable().optional()
 });
 var PlatformScoreSchema = zod.z.object({
 	runtime: zod.z.enum(["node", "python"]),
@@ -26436,6 +26590,12 @@ Object.defineProperty(exports, "expandCapMethods", {
 		return expandCapMethods;
 	}
 });
+Object.defineProperty(exports, "extractNestedAddonId", {
+	enumerable: true,
+	get: function() {
+		return extractNestedAddonId;
+	}
+});
 Object.defineProperty(exports, "filesystemBrowseCapability", {
 	enumerable: true,
 	get: function() {
@@ -26532,6 +26692,12 @@ Object.defineProperty(exports, "normalizeUnit", {
 		return normalizeUnit;
 	}
 });
+Object.defineProperty(exports, "objectInputDeclaresAddonId", {
+	enumerable: true,
+	get: function() {
+		return objectInputDeclaresAddonId;
+	}
+});
 Object.defineProperty(exports, "parseJsonObject", {
 	enumerable: true,
 	get: function() {

package/dist/index.d.ts

@@ -10,6 +10,8 @@ export { proxyToUpstream } from './http/reverse-proxy.js';
 export type { ReverseProxyOptions } from './http/reverse-proxy.js';
 export { createFileDataPlaneHandler } from './http/file-data-plane.js';
 export type { FileDataPlaneOptions } from './http/file-data-plane.js';
+export { createAddonDataPlaneFacility } from './kernel/moleculer/addon-data-plane-facility.js';
+export type { AddonDataPlaneFacility, DataPlaneSink, } from './kernel/moleculer/addon-data-plane-facility.js';
 export { downloadModel, downloadFile, fetchJson, ensureModel, getModelFilePath, isModelDownloaded, deleteModelFromDisk, collectModelFiles, } from './download/model-downloader.js';
 export type { DownloadProgressCallback } from './download/model-downloader.js';
 export { ModelDownloadService } from './download/model-download-service.js';

package/dist/index.js

@@ -1,7 +1,8 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_chunk = require("./chunk-Cek0wNdY.js");
-const require_dist = require("./dist-BDV1WKRg.js");
+const require_dist = require("./dist-C3uHEBtP.js");
 const require_model_download_service = require("./model-download-service-D-Umz4-L.js");
+const require_manifest_python_deps = require("./manifest-python-deps-CVcJ9hDX.js");
 const require_resource_monitor = require("./resource-monitor-DNNomR-i.js");
 const require_builtins_sqlite_storage_filesystem_storage_addon = require("./builtins/sqlite-storage/filesystem-storage.addon.js");
 const require_builtins_sqlite_storage_sqlite_settings_addon = require("./builtins/sqlite-storage/sqlite-settings.addon.js");
@@ -21,7 +22,6 @@ const require_builtins_local_auth_local_auth_addon = require("./builtins/local-a
 require("./builtins/local-auth/index.js");
 const require_builtins_device_manager_device_manager_addon = require("./builtins/device-manager/device-manager.addon.js");
 require("./builtins/device-manager/index.js");
-const require_manifest_python_deps = require("./manifest-python-deps-DAA0ULwT.js");
 const require_custom_action_registry = require("./custom-action-registry-vLYEFTtv.js");
 let _camstack_types_node = require("@camstack/types/node");
 let zod = require("zod");
@@ -32,6 +32,7 @@ node_fs = require_chunk.__toESM(node_fs);
 let node_path = require("node:path");
 node_path = require_chunk.__toESM(node_path, 1);
 let node_crypto = require("node:crypto");
+let _camstack_types_addon = require("@camstack/types/addon");
 let node_child_process = require("node:child_process");
 let node_util = require("node:util");
 node_util = require_chunk.__toESM(node_util);
@@ -40,7 +41,6 @@ node_vm = require_chunk.__toESM(node_vm);
 let node_os = require("node:os");
 node_os = require_chunk.__toESM(node_os);
 let node_fs_promises = require("node:fs/promises");
-let _camstack_types_addon = require("@camstack/types/addon");
 let node_events = require("node:events");
 let node_stream = require("node:stream");
 node_stream = require_chunk.__toESM(node_stream, 1);
@@ -3064,6 +3064,24 @@ var AddonInstaller = class AddonInstaller {
 		else this.installSource = "npm";
 	}
 	/**
+	* Where a bootstrapped npm lives when the host has none on PATH (packaged
+	* Electron agents ship a bare node binary). Persistent — sibling of the
+	* installed addons, survives restarts, downloaded at most once per host.
+	*/
+	get npmCacheDir() {
+		return node_path.join(this.addonsDir, ".npm-bootstrap");
+	}
+	/** Shared options for every npm invocation this installer performs. */
+	npmRunOptions(cwd, timeout) {
+		return {
+			cacheDir: this.npmCacheDir,
+			registry: this.registry,
+			logger: this.logger,
+			cwd,
+			timeout
+		};
+	}
+	/**
 	* Derive the bootstrap addon list from a meta-package's runtime dependencies.
 	* Single source of truth: the meta-package's `package.json` declares which
 	* `@camstack/addon-*` packages the deployment needs. Replaces previously
@@ -3247,17 +3265,16 @@ var AddonInstaller = class AddonInstaller {
 		});
 		const strippedDeps = stripBundledDeps(pkgData);
 		if (strippedDeps["dependencies"] && typeof strippedDeps["dependencies"] === "object" && Object.keys(strippedDeps["dependencies"]).length > 0) try {
-			await execFileAsync("npm", [
+			await require_manifest_python_deps.runNpm([
 				"install",
 				"--omit=dev",
 				"--ignore-scripts=false"
-			], {
-				cwd: targetDir,
-				timeout: 12e4
-			});
-		} catch {}
+			], this.npmRunOptions(targetDir, 12e4));
+		} catch (err) {
+			this.logger.warn(`${packageName} — npm install failed (continuing)`, { meta: { error: require_dist.errMsg(err) } });
+		}
 		try {
-			await require_manifest_python_deps.installManifestNativeDeps(targetDir, pkgData, this.logger, this.registry);
+			await require_manifest_python_deps.installManifestNativeDeps(targetDir, pkgData, this.logger, this.registry, this.npmCacheDir);
 		} catch (err) {
 			this.logger.warn(`${packageName} — native deps install failed (continuing)`, { meta: { error: require_dist.errMsg(err) } });
 		}
@@ -3288,7 +3305,7 @@ var AddonInstaller = class AddonInstaller {
 					tmpDir
 				];
 				if (this.registry) args.push("--registry", this.registry);
-				const { stdout } = await execFileAsync("npm", args, { timeout: 12e4 });
+				const { stdout } = await require_manifest_python_deps.runNpm(args, this.npmRunOptions(tmpDir, 12e4));
 				const tgzFiles = node_fs.readdirSync(tmpDir).filter((f) => f.endsWith(".tgz"));
 				if (tgzFiles.length === 0) throw new Error(`npm pack produced no tgz. stdout: ${stdout.trim()}`);
 				return node_path.join(tmpDir, tgzFiles[0]);
@@ -3429,7 +3446,7 @@ var AddonInstaller = class AddonInstaller {
 			if (strippedRuntimeDeps != null && typeof strippedRuntimeDeps === "object" && Object.keys(strippedRuntimeDeps).length > 0) {
 				this.logger.info(`${pkgView.name} — installing runtime dependencies`, { meta: { stagingDir: pkgDir } });
 				try {
-					await execFileAsync("npm", [
+					await require_manifest_python_deps.runNpm([
 						"install",
 						"--omit=dev",
 						"--omit=peer",
@@ -3437,16 +3454,13 @@ var AddonInstaller = class AddonInstaller {
 						"--no-fund",
 						"--no-package-lock",
 						...this.registry ? ["--registry", this.registry] : []
-					], {
-						cwd: pkgDir,
-						timeout: 24e4
-					});
+					], this.npmRunOptions(pkgDir, 24e4));
 				} catch (err) {
-					this.logger.warn(`${pkgView.name} — npm install failed (continuing)`, { meta: { error: err instanceof Error ? err.message : String(err) } });
+					throw new Error(`${pkgView.name} — runtime dependency install failed: ${require_dist.errMsg(err)}`, { cause: err });
 				}
 			}
 			try {
-				await require_manifest_python_deps.installManifestNativeDeps(pkgDir, pkgView.raw, this.logger, this.registry);
+				await require_manifest_python_deps.installManifestNativeDeps(pkgDir, pkgView.raw, this.logger, this.registry, this.npmCacheDir);
 			} catch (nativeErr) {
 				throw new Error(`${pkgView.name} — native deps install failed: ${require_dist.errMsg(nativeErr)}`, { cause: nativeErr });
 			}
@@ -3748,10 +3762,7 @@ var AddonInstaller = class AddonInstaller {
 		if (!(!node_fs.existsSync(distDir) || this.isDistIncomplete(pkgData, sourceDir))) return;
 		this.logger.info(`${packageName} — building (dist/ missing or incomplete)`);
 		try {
-			await execFileAsync("npm", ["run", "build"], {
-				cwd: sourceDir,
-				timeout: 18e4
-			});
+			await require_manifest_python_deps.runNpm(["run", "build"], this.npmRunOptions(sourceDir, 18e4));
 		} catch (err) {
 			const msg = require_dist.errMsg(err);
 			this.logger.warn(`${packageName} auto-build failed`, { meta: { error: msg } });
@@ -5121,7 +5132,9 @@ function buildOneCapRouter(def, primitives, services) {
 				if (isCollection) {
 					const { rest, picked } = stripKeys(input, ["nodeId", "addonId"]);
 					const nodeId = typeof picked.nodeId === "string" ? picked.nodeId : void 0;
-					const addonId = typeof picked.addonId === "string" ? picked.addonId : void 0;
+					const topLevelAddonId = typeof picked.addonId === "string" ? picked.addonId : void 0;
+					const canRecoverNestedAddonId = !require_dist.isArrayOutputSchema(method.schema.output) && !require_dist.objectInputDeclaresAddonId(method.schema.input);
+					const addonId = topLevelAddonId ?? (canRecoverNestedAddonId ? require_dist.extractNestedAddonId(rest) : void 0);
 					return resolveProviderForCall(capName, nodeId, () => getLocal(ctx, addonId), services)[method.name]?.(rest);
 				}
 				const { rest, picked } = stripKeys(input, ["nodeId"]);
@@ -93513,6 +93526,7 @@ exports.contentTypeFor = require_model_download_service.contentTypeFor;
 exports.copyDirRecursive = copyDirRecursive;
 exports.copyExtraFileDirs = copyExtraFileDirs;
 exports.createAddonContext = require_manifest_python_deps.createAddonContext;
+exports.createAddonDataPlaneFacility = require_manifest_python_deps.createAddonDataPlaneFacility;
 exports.createAddonService = require_manifest_python_deps.createAddonService;
 exports.createAuthenticatedFileServer = require_model_download_service.createAuthenticatedFileServer;
 exports.createBroker = createBroker;

package/dist/index.mjs

@@ -1,5 +1,6 @@
-import { A as isObjectInput, Ct as readinessKey, H as procedureAuthKey, I as looseSchema, M as kebabToCamel, N as lifecycleJobSchema, O as isArrayOutputSchema, St as parseJsonUnknown$1, Tt as scopeKey, ct as EventCategory$1, et as errMsg$1, ft as asJsonObject$1, gt as emitDownForOwnedCaps, ht as createEvent, it as DEVICE_STATUS_METHOD, j as isVoidInput, k as isCollectionArrayMethod, lt as ReadinessRegistry, mt as asString$1, nt as DATAPLANE_SECRET_HEADER$1, o as METHOD_ACCESS_MAP, p as addonSettingsCapability, pt as asNumber, rt as DEVICE_SETTINGS_CONTRIBUTION_METHODS, s as RUNTIME_DEFAULTS, t as ALL_CAPABILITY_DEFINITIONS, ut as ReadinessTimeoutError, vt as expandCapMethods, wt as resolveCapMount, xt as parseJsonObject } from "./dist-8phgmJ6b.mjs";
+import { A as isCollectionArrayMethod, Ct as parseJsonUnknown$1, E as extractNestedAddonId, Et as scopeKey, L as looseSchema, M as isVoidInput, N as kebabToCamel, Ot as EventCategory$1, P as lifecycleJobSchema, St as parseJsonObject, Tt as resolveCapMount, V as objectInputDeclaresAddonId, W as procedureAuthKey, _t as emitDownForOwnedCaps, at as DEVICE_SETTINGS_CONTRIBUTION_METHODS, dt as ReadinessTimeoutError, gt as createEvent, ht as asString$1, it as DATAPLANE_SECRET_HEADER$1, j as isObjectInput, k as isArrayOutputSchema, mt as asNumber, nt as errMsg$1, o as METHOD_ACCESS_MAP, ot as DEVICE_STATUS_METHOD, p as addonSettingsCapability, pt as asJsonObject$1, s as RUNTIME_DEFAULTS, t as ALL_CAPABILITY_DEFINITIONS, ut as ReadinessRegistry, wt as readinessKey, yt as expandCapMethods } from "./dist-BWQX9yUj.mjs";
 import { a as downloadModel, c as getModelFilePath, d as contentTypeFor, f as createAuthenticatedFileServer, h as resolveFilePath, i as downloadFile, l as isModelDownloaded, m as parseTokenizedUrl, n as collectModelFiles, o as ensureModel, p as parseRangeHeader, r as deleteModelFromDisk, s as fetchJson, t as ModelDownloadService, u as createFileDataPlaneHandler } from "./model-download-service-C-IHWnXx.mjs";
+import { $ as buildUdsNativeCapProxy, A as createParentUnownedCallHandler, B as AGENT_CAP_FWD_SERVICE, C as buildLinkChain, D as HUB_CAP_FWD_ACTION, E as localProviderLink, F as createUdsLoggerWithControl, G as createLocalTransport, H as CapRouteError, I as LocalChildClient, J as SocketChannel, K as UdsLocalTransportClient, L as LocalChildRegistry, M as createUdsEventBus, N as udsChildLogToWorkerEntry, O as HUB_CAP_FWD_SERVICE, P as createUdsLogger, Q as buildNativeCapProxy, R as UDS_NO_ROUTE_PREFIX, S as brokerTransportLink, T as ipcParentLink, U as classifyCapRoute, V as CapRouteResolver, W as callWithServiceDiscovery, X as FrameDecoder, Y as localEndpointPath, Z as encodeFrame, _ as resolveHwAccel, _t as CapabilityUnavailableError, a as getWorkerDeviceRegistry, at as createAddonService, b as getCapUsageRegistry, bt as resolveAddonClass, c as setHubConnected, ct as capActionName, d as getMoleculerEventStats, dt as capServiceName, et as createBrokerDeviceManagerApi, f as registerEventBusService, ft as parseCapAction, g as createKernelHwAccel, gt as CapabilityHandle, h as AddonDepsManager, ht as DeviceRegistry, i as createUdsAddonContext, j as createUdsEventBridge, k as createHubCapForwardService, l as EVENT_TOPIC_PREFIX, lt as capActionSuffix, m as subscribePassthrough, mt as serializeTypedArrays, n as adaptBrokerToCluster, o as getOrInitReadinessRegistry, ot as validateProviderRegistrations, p as setNodeEventInterest, pt as deserializeTypedArrays, q as UdsLocalTransportServer, r as createAddonContext, rt as mountNativeCapService, s as getOrInitReadinessRegistryForClient, st as NATIVE_PROVIDER_SERVICE_INFIX, t as installManifestPythonDeps, u as getBrokerEventBus, ut as capBareAction, v as CapUsageRegistry, vt as installManifestNativeDeps, w as ipcChildLink, x as brokerCallForCap, xt as createAddonDataPlaneFacility, y as __resetCapUsageRegistryForTests, yt as runNpm, z as AGENT_CAP_FWD_ACTION } from "./manifest-python-deps-BA6KA9If.mjs";
 import { n as getSinglePidStats, t as getPidStats } from "./resource-monitor-Le3l0qS2.mjs";
 import { FilesystemStorageAddon, t as FilesystemStorageProvider } from "./builtins/sqlite-storage/filesystem-storage.addon.mjs";
 import { SqliteSettingsAddon, t as SqliteSettingsBackend } from "./builtins/sqlite-storage/sqlite-settings.addon.mjs";
@@ -19,7 +20,6 @@ import { LocalAuthAddon, a as require_ms, c as __esmMin, d as __toCommonJS, f as
 import "./builtins/local-auth/index.mjs";
 import { DeviceManagerAddon } from "./builtins/device-manager/device-manager.addon.mjs";
 import "./builtins/device-manager/index.mjs";
-import { $ as buildUdsNativeCapProxy, A as createParentUnownedCallHandler, B as AGENT_CAP_FWD_SERVICE, C as buildLinkChain, D as HUB_CAP_FWD_ACTION, E as localProviderLink, F as createUdsLoggerWithControl, G as createLocalTransport, H as CapRouteError, I as LocalChildClient, J as SocketChannel, K as UdsLocalTransportClient, L as LocalChildRegistry, M as createUdsEventBus, N as udsChildLogToWorkerEntry, O as HUB_CAP_FWD_SERVICE, P as createUdsLogger, Q as buildNativeCapProxy, R as UDS_NO_ROUTE_PREFIX, S as brokerTransportLink, T as ipcParentLink, U as classifyCapRoute, V as CapRouteResolver, W as callWithServiceDiscovery, X as FrameDecoder, Y as localEndpointPath, Z as encodeFrame, _ as resolveHwAccel, _t as CapabilityUnavailableError, a as getWorkerDeviceRegistry, at as createAddonService, b as getCapUsageRegistry, c as setHubConnected, ct as capActionName, d as getMoleculerEventStats, dt as capServiceName, et as createBrokerDeviceManagerApi, f as registerEventBusService, ft as parseCapAction, g as createKernelHwAccel, gt as CapabilityHandle, h as AddonDepsManager, ht as DeviceRegistry, i as createUdsAddonContext, j as createUdsEventBridge, k as createHubCapForwardService, l as EVENT_TOPIC_PREFIX, lt as capActionSuffix, m as subscribePassthrough, mt as serializeTypedArrays, n as adaptBrokerToCluster, o as getOrInitReadinessRegistry, ot as validateProviderRegistrations, p as setNodeEventInterest, pt as deserializeTypedArrays, q as UdsLocalTransportServer, r as createAddonContext, rt as mountNativeCapService, s as getOrInitReadinessRegistryForClient, st as NATIVE_PROVIDER_SERVICE_INFIX, t as installManifestPythonDeps, u as getBrokerEventBus, ut as capBareAction, v as CapUsageRegistry, vt as installManifestNativeDeps, w as ipcChildLink, x as brokerCallForCap, y as __resetCapUsageRegistryForTests, yt as resolveAddonClass, z as AGENT_CAP_FWD_ACTION } from "./manifest-python-deps-B09I9ems.mjs";
 import { t as CustomActionRegistry } from "./custom-action-registry-BEXwC-oo.mjs";
 import { PYTHON_VERSION, buildBinaryPath, downloadBinary, ensureBinary, ensureFfmpeg, ensurePython, findInPath, getFfmpegDownloadUrl, getPlatformInfo, getPythonDownloadUrl, installPythonPackages, installPythonRequirements } from "@camstack/types/node";
 import { z } from "zod";
@@ -29,13 +29,13 @@ import { accessSync, constants, existsSync, mkdirSync, readFileSync } from "node
 import * as path$39 from "node:path";
 import { dirname, isAbsolute, join, posix, resolve, win32 } from "node:path";
 import { X509Certificate, createHash, randomUUID, timingSafeEqual } from "node:crypto";
+import { asJsonObject, parseJsonUnknown } from "@camstack/types/addon";
 import { execFile, spawn } from "node:child_process";
 import * as util$10 from "node:util";
 import { promisify } from "node:util";
 import * as vm from "node:vm";
 import * as os$18 from "node:os";
 import { lstat, readdir, readlink, realpath } from "node:fs/promises";
-import { asJsonObject, parseJsonUnknown } from "@camstack/types/addon";
 import { EventEmitter } from "node:events";
 import As from "node:stream";
 import { StringDecoder } from "node:string_decoder";
@@ -3056,6 +3056,24 @@ var AddonInstaller = class AddonInstaller {
 		else this.installSource = "npm";
 	}
 	/**
+	* Where a bootstrapped npm lives when the host has none on PATH (packaged
+	* Electron agents ship a bare node binary). Persistent — sibling of the
+	* installed addons, survives restarts, downloaded at most once per host.
+	*/
+	get npmCacheDir() {
+		return path$39.join(this.addonsDir, ".npm-bootstrap");
+	}
+	/** Shared options for every npm invocation this installer performs. */
+	npmRunOptions(cwd, timeout) {
+		return {
+			cacheDir: this.npmCacheDir,
+			registry: this.registry,
+			logger: this.logger,
+			cwd,
+			timeout
+		};
+	}
+	/**
 	* Derive the bootstrap addon list from a meta-package's runtime dependencies.
 	* Single source of truth: the meta-package's `package.json` declares which
 	* `@camstack/addon-*` packages the deployment needs. Replaces previously
@@ -3239,17 +3257,16 @@ var AddonInstaller = class AddonInstaller {
 		});
 		const strippedDeps = stripBundledDeps(pkgData);
 		if (strippedDeps["dependencies"] && typeof strippedDeps["dependencies"] === "object" && Object.keys(strippedDeps["dependencies"]).length > 0) try {
-			await execFileAsync("npm", [
+			await runNpm([
 				"install",
 				"--omit=dev",
 				"--ignore-scripts=false"
-			], {
-				cwd: targetDir,
-				timeout: 12e4
-			});
-		} catch {}
+			], this.npmRunOptions(targetDir, 12e4));
+		} catch (err) {
+			this.logger.warn(`${packageName} — npm install failed (continuing)`, { meta: { error: errMsg$1(err) } });
+		}
 		try {
-			await installManifestNativeDeps(targetDir, pkgData, this.logger, this.registry);
+			await installManifestNativeDeps(targetDir, pkgData, this.logger, this.registry, this.npmCacheDir);
 		} catch (err) {
 			this.logger.warn(`${packageName} — native deps install failed (continuing)`, { meta: { error: errMsg$1(err) } });
 		}
@@ -3280,7 +3297,7 @@ var AddonInstaller = class AddonInstaller {
 					tmpDir
 				];
 				if (this.registry) args.push("--registry", this.registry);
-				const { stdout } = await execFileAsync("npm", args, { timeout: 12e4 });
+				const { stdout } = await runNpm(args, this.npmRunOptions(tmpDir, 12e4));
 				const tgzFiles = fs$17.readdirSync(tmpDir).filter((f) => f.endsWith(".tgz"));
 				if (tgzFiles.length === 0) throw new Error(`npm pack produced no tgz. stdout: ${stdout.trim()}`);
 				return path$39.join(tmpDir, tgzFiles[0]);
@@ -3421,7 +3438,7 @@ var AddonInstaller = class AddonInstaller {
 			if (strippedRuntimeDeps != null && typeof strippedRuntimeDeps === "object" && Object.keys(strippedRuntimeDeps).length > 0) {
 				this.logger.info(`${pkgView.name} — installing runtime dependencies`, { meta: { stagingDir: pkgDir } });
 				try {
-					await execFileAsync("npm", [
+					await runNpm([
 						"install",
 						"--omit=dev",
 						"--omit=peer",
@@ -3429,16 +3446,13 @@ var AddonInstaller = class AddonInstaller {
 						"--no-fund",
 						"--no-package-lock",
 						...this.registry ? ["--registry", this.registry] : []
-					], {
-						cwd: pkgDir,
-						timeout: 24e4
-					});
+					], this.npmRunOptions(pkgDir, 24e4));
 				} catch (err) {
-					this.logger.warn(`${pkgView.name} — npm install failed (continuing)`, { meta: { error: err instanceof Error ? err.message : String(err) } });
+					throw new Error(`${pkgView.name} — runtime dependency install failed: ${errMsg$1(err)}`, { cause: err });
 				}
 			}
 			try {
-				await installManifestNativeDeps(pkgDir, pkgView.raw, this.logger, this.registry);
+				await installManifestNativeDeps(pkgDir, pkgView.raw, this.logger, this.registry, this.npmCacheDir);
 			} catch (nativeErr) {
 				throw new Error(`${pkgView.name} — native deps install failed: ${errMsg$1(nativeErr)}`, { cause: nativeErr });
 			}
@@ -3740,10 +3754,7 @@ var AddonInstaller = class AddonInstaller {
 		if (!(!fs$17.existsSync(distDir) || this.isDistIncomplete(pkgData, sourceDir))) return;
 		this.logger.info(`${packageName} — building (dist/ missing or incomplete)`);
 		try {
-			await execFileAsync("npm", ["run", "build"], {
-				cwd: sourceDir,
-				timeout: 18e4
-			});
+			await runNpm(["run", "build"], this.npmRunOptions(sourceDir, 18e4));
 		} catch (err) {
 			const msg = errMsg$1(err);
 			this.logger.warn(`${packageName} auto-build failed`, { meta: { error: msg } });
@@ -5113,7 +5124,9 @@ function buildOneCapRouter(def, primitives, services) {
 				if (isCollection) {
 					const { rest, picked } = stripKeys(input, ["nodeId", "addonId"]);
 					const nodeId = typeof picked.nodeId === "string" ? picked.nodeId : void 0;
-					const addonId = typeof picked.addonId === "string" ? picked.addonId : void 0;
+					const topLevelAddonId = typeof picked.addonId === "string" ? picked.addonId : void 0;
+					const canRecoverNestedAddonId = !isArrayOutputSchema(method.schema.output) && !objectInputDeclaresAddonId(method.schema.input);
+					const addonId = topLevelAddonId ?? (canRecoverNestedAddonId ? extractNestedAddonId(rest) : void 0);
 					return resolveProviderForCall(capName, nodeId, () => getLocal(ctx, addonId), services)[method.name]?.(rest);
 				}
 				const { rest, picked } = stripKeys(input, ["nodeId"]);
@@ -93368,4 +93381,4 @@ async function stageFrameworkLockstep(input) {
 	return results;
 }
 //#endregion
-export { AGENT_CAP_FWD_ACTION, AGENT_CAP_FWD_SERVICE, ALL_CAPABILITY_DEFINITIONS, AddonApiFactory, AddonDepsManager, AddonEngineManager, AddonHealthMonitor, AddonInstaller, AddonLoader, AddonManifest, AddonRouteRegistry, AlertCenterAddon, ApiKeyManager, AuthManager, CLUSTER_SECRET_MISMATCH_TYPE, CLUSTER_SECRET_REJECTED_EXIT_CODE, CORE_CAP_SERVICE_NAME, CapRouteError, CapRouteResolver, CapUsageRegistry, CapabilityHandle, CapabilityRegistry, CapabilityUnavailableError, ConfigManager, ConfigStore, ConsoleDestination, ConsoleLoggingAddon, CustomActionRegistry, DEFAULT_DATA_PATH, DEVICE_SETTINGS_CONTRIBUTION_METHODS, DEVICE_STATUS_METHOD, DataPlaneRegistry, DeviceManagerAddon, DeviceRegistry, DeviceStore, EVENT_TOPIC_PREFIX, EngineManagerResolver, EventBus, FRAMEWORK_LOCKSTEP, FeatureManager, FilesystemStorageAddon, FilesystemStorageProvider, FrameDecoder, FsStorageBackend, HEALTH_MONITOR_GRACE_PERIOD_MS, HEALTH_MONITOR_RETRY_INTERVALS_MS, HEALTH_MONITOR_TICK_MS, HUB_CAP_FWD_ACTION, HUB_CAP_FWD_SERVICE, HubForwarderAddon, HubForwarderDestination, HubLogForwarder, HubNodeRegistry, INFRA_CAPABILITIES, IntegrationRegistry, JobJournal, LifecycleJobEngine, LifecycleStateMachine, LocalAuthAddon, LocalChildClient, LocalChildRegistry, LogManager, LogRingBuffer, METHOD_ACCESS_MAP, ModelDownloadService, NATIVE_PROVIDER_SERVICE_INFIX, NativeMetricsAddon, NativeMetricsProvider, NetworkQualityTracker, NotificationService, PYTHON_VERSION, PipelineRunner, PipelineValidator, PythonEnvManager, RESTART_MARKER_FILE, RUNTIME_DEFAULTS, ReadinessRegistry, ReadinessTimeoutError, ReplEngine, RingBuffer, ScopedLogger, ScopedTokenManager, SocketChannel, SqliteSettingsAddon, SqliteSettingsBackend, StagingArea, StorageLocationManager, StorageManager, StorageOrchestratorAddon, StorageOrchestratorService, SystemConfigAddon, SystemEventBus, ToastService, UDS_NO_ROUTE_PREFIX, UdsLocalTransportClient, UdsLocalTransportServer, UserManager, WinstonDestination, WinstonLoggingAddon, __resetCapUsageRegistryForTests, adaptBrokerToCluster, addonSettingsCapability, bootstrapSchema, brokerCallForCap, brokerTransportLink, buildBinaryPath, buildCapRouters, buildLinkChain, buildNativeCapProxy, buildNodeManifest, buildStorageLocationRegistry, buildUdsNativeCapProxy, builderMountedCapNames, callRegisterNodeWithRetry, callWithServiceDiscovery, capActionName, capActionSuffix, capBareAction, capServiceName, classifyCapRoute, clearPendingRestart, clusterSecretMatches, collectModelFiles, contentTypeFor, copyDirRecursive, copyExtraFileDirs, createAddonContext, createAddonService, createAuthenticatedFileServer, createBroker, createBrokerDeviceManagerApi, createCoreCapService, createFileDataPlaneHandler, createHubCapForwardService, createHubService, createKernelHwAccel, createLocalTransport, createParentUnownedCallHandler, createProcessService, createReadinessService, createReadinessServiceForRegistry, createScopedProcessManager, createStreamProbeBrokerService, createUdsAddonContext, createUdsEventBridge, createUdsEventBus, createUdsLogger, createUdsLoggerWithControl, deleteModelFromDisk, deriveAgentListenPort, describeProviderKindDrift, detectWorkspacePackagesDir, downloadBinary, downloadFile, downloadModel, emitDownForOwnedCaps, encodeFrame, ensureBinary, ensureDir, ensureFfmpeg, ensureLibraryBuilt, ensureModel, ensurePython, ensureTlsCert, expandCapMethods, fetchJson, findInPath, formatLogLine, getBrokerEventBus, getCapUsageRegistry, getFfmpegDownloadUrl, getModelFilePath, getMoleculerEventStats, getOrInitReadinessRegistry, getOrInitReadinessRegistryForClient, getPidStats, getPlatformInfo, getPythonDownloadUrl, getRestartMarkerPath, getSinglePidStats, getWorkerDeviceRegistry, hashClusterSecret, installManifestNativeDeps, installManifestPythonDeps, installPackageFromNpm, installPythonPackages, installPythonRequirements, ipcChildLink, ipcParentLink, isAddonDeploySource, isArrayOutputSchema, isClusterSecretMismatchError, isCollectionArrayMethod, isInfraCapability, isModelDownloaded, isSourceNewer, loadTlsCert, localEndpointPath, localProviderLink, mountNativeCapService, parseCapAction, parseRangeHeader, parseTokenizedUrl, proxyToUpstream, readPendingRestart, readinessKey, registerEventBusService, resolveFilePath, resolveHwAccel, scheduleSelfRestart, scopeKey, scopesAllowDeviceCap, serializeTypedArrays, setHubConnected, setNodeEventInterest, stageFrameworkLockstep, stripCamstackDeps, subscribePassthrough, udsChildLogToWorkerEntry, validateProviderRegistrations, writePendingRestart };
+export { AGENT_CAP_FWD_ACTION, AGENT_CAP_FWD_SERVICE, ALL_CAPABILITY_DEFINITIONS, AddonApiFactory, AddonDepsManager, AddonEngineManager, AddonHealthMonitor, AddonInstaller, AddonLoader, AddonManifest, AddonRouteRegistry, AlertCenterAddon, ApiKeyManager, AuthManager, CLUSTER_SECRET_MISMATCH_TYPE, CLUSTER_SECRET_REJECTED_EXIT_CODE, CORE_CAP_SERVICE_NAME, CapRouteError, CapRouteResolver, CapUsageRegistry, CapabilityHandle, CapabilityRegistry, CapabilityUnavailableError, ConfigManager, ConfigStore, ConsoleDestination, ConsoleLoggingAddon, CustomActionRegistry, DEFAULT_DATA_PATH, DEVICE_SETTINGS_CONTRIBUTION_METHODS, DEVICE_STATUS_METHOD, DataPlaneRegistry, DeviceManagerAddon, DeviceRegistry, DeviceStore, EVENT_TOPIC_PREFIX, EngineManagerResolver, EventBus, FRAMEWORK_LOCKSTEP, FeatureManager, FilesystemStorageAddon, FilesystemStorageProvider, FrameDecoder, FsStorageBackend, HEALTH_MONITOR_GRACE_PERIOD_MS, HEALTH_MONITOR_RETRY_INTERVALS_MS, HEALTH_MONITOR_TICK_MS, HUB_CAP_FWD_ACTION, HUB_CAP_FWD_SERVICE, HubForwarderAddon, HubForwarderDestination, HubLogForwarder, HubNodeRegistry, INFRA_CAPABILITIES, IntegrationRegistry, JobJournal, LifecycleJobEngine, LifecycleStateMachine, LocalAuthAddon, LocalChildClient, LocalChildRegistry, LogManager, LogRingBuffer, METHOD_ACCESS_MAP, ModelDownloadService, NATIVE_PROVIDER_SERVICE_INFIX, NativeMetricsAddon, NativeMetricsProvider, NetworkQualityTracker, NotificationService, PYTHON_VERSION, PipelineRunner, PipelineValidator, PythonEnvManager, RESTART_MARKER_FILE, RUNTIME_DEFAULTS, ReadinessRegistry, ReadinessTimeoutError, ReplEngine, RingBuffer, ScopedLogger, ScopedTokenManager, SocketChannel, SqliteSettingsAddon, SqliteSettingsBackend, StagingArea, StorageLocationManager, StorageManager, StorageOrchestratorAddon, StorageOrchestratorService, SystemConfigAddon, SystemEventBus, ToastService, UDS_NO_ROUTE_PREFIX, UdsLocalTransportClient, UdsLocalTransportServer, UserManager, WinstonDestination, WinstonLoggingAddon, __resetCapUsageRegistryForTests, adaptBrokerToCluster, addonSettingsCapability, bootstrapSchema, brokerCallForCap, brokerTransportLink, buildBinaryPath, buildCapRouters, buildLinkChain, buildNativeCapProxy, buildNodeManifest, buildStorageLocationRegistry, buildUdsNativeCapProxy, builderMountedCapNames, callRegisterNodeWithRetry, callWithServiceDiscovery, capActionName, capActionSuffix, capBareAction, capServiceName, classifyCapRoute, clearPendingRestart, clusterSecretMatches, collectModelFiles, contentTypeFor, copyDirRecursive, copyExtraFileDirs, createAddonContext, createAddonDataPlaneFacility, createAddonService, createAuthenticatedFileServer, createBroker, createBrokerDeviceManagerApi, createCoreCapService, createFileDataPlaneHandler, createHubCapForwardService, createHubService, createKernelHwAccel, createLocalTransport, createParentUnownedCallHandler, createProcessService, createReadinessService, createReadinessServiceForRegistry, createScopedProcessManager, createStreamProbeBrokerService, createUdsAddonContext, createUdsEventBridge, createUdsEventBus, createUdsLogger, createUdsLoggerWithControl, deleteModelFromDisk, deriveAgentListenPort, describeProviderKindDrift, detectWorkspacePackagesDir, downloadBinary, downloadFile, downloadModel, emitDownForOwnedCaps, encodeFrame, ensureBinary, ensureDir, ensureFfmpeg, ensureLibraryBuilt, ensureModel, ensurePython, ensureTlsCert, expandCapMethods, fetchJson, findInPath, formatLogLine, getBrokerEventBus, getCapUsageRegistry, getFfmpegDownloadUrl, getModelFilePath, getMoleculerEventStats, getOrInitReadinessRegistry, getOrInitReadinessRegistryForClient, getPidStats, getPlatformInfo, getPythonDownloadUrl, getRestartMarkerPath, getSinglePidStats, getWorkerDeviceRegistry, hashClusterSecret, installManifestNativeDeps, installManifestPythonDeps, installPackageFromNpm, installPythonPackages, installPythonRequirements, ipcChildLink, ipcParentLink, isAddonDeploySource, isArrayOutputSchema, isClusterSecretMismatchError, isCollectionArrayMethod, isInfraCapability, isModelDownloaded, isSourceNewer, loadTlsCert, localEndpointPath, localProviderLink, mountNativeCapService, parseCapAction, parseRangeHeader, parseTokenizedUrl, proxyToUpstream, readPendingRestart, readinessKey, registerEventBusService, resolveFilePath, resolveHwAccel, scheduleSelfRestart, scopeKey, scopesAllowDeviceCap, serializeTypedArrays, setHubConnected, setNodeEventInterest, stageFrameworkLockstep, stripCamstackDeps, subscribePassthrough, udsChildLogToWorkerEntry, validateProviderRegistrations, writePendingRestart };

package/dist/kernel/addon-installer.d.ts

@@ -49,6 +49,14 @@ export declare class AddonInstaller {
      */
     readonly manifest: AddonManifest;
     constructor(config: AddonInstallerConfig, logger?: IScopedLogger);
+    /**
+     * Where a bootstrapped npm lives when the host has none on PATH (packaged
+     * Electron agents ship a bare node binary). Persistent — sibling of the
+     * installed addons, survives restarts, downloaded at most once per host.
+     */
+    private get npmCacheDir();
+    /** Shared options for every npm invocation this installer performs. */
+    private npmRunOptions;
     /**
      * Derive the bootstrap addon list from a meta-package's runtime dependencies.
      * Single source of truth: the meta-package's `package.json` declares which

package/dist/kernel/deps/manifest-native-deps.d.ts

@@ -22,4 +22,4 @@ import { IScopedLogger } from '@camstack/types';
  *     ABI; surface a clear error at first `import` of the native module
  *     otherwise).
  */
-export declare function installManifestNativeDeps(addonDir: string, pkgRaw: Record<string, unknown>, logger: IScopedLogger, registry?: string): Promise<void>;
+export declare function installManifestNativeDeps(addonDir: string, pkgRaw: Record<string, unknown>, logger: IScopedLogger, registry?: string, npmCacheDir?: string): Promise<void>;