@camstack/types 1.1.2 → 1.1.4

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

@@ -229,9 +229,17 @@ export declare abstract class BaseAddon<TConfig extends object = Record<string,
      */
     private emitReadinessForProviders;
     /**
-     * Resolve the shared models directory path via the storage capability.
-     * Falls back to `camstack-data/models` if storage is unavailable.
-     * Used by inference addons (detection-pipeline, audio-classifier, embedding-encoder).
+     * Resolve the shared, node-local models directory: `<nodeDataDir>/models`.
+     *
+     * This is the SINGLE centralized models-dir resolver for every inference addon
+     * (detection-pipeline, audio-analyzer, embedding-encoder, model-studio). It is
+     * anchored at the node's own writable data root (`ctx.nodeDataDir`, i.e.
+     * `CAMSTACK_DATA` ?? the kernel boot dir) — never the hub-singleton `storage`
+     * cap, which returns the hub's `/data/models` to every node and breaks any node
+     * whose real data dir differs (e.g. the macOS electron agent).
+     *
+     * `node:path`/`node:fs` are imported dynamically so the `@camstack/types` root
+     * barrel (re-exported into browser bundles) stays free of node builtins.
      */
     protected resolveModelsDir(): Promise<string>;
     /**

package/dist/addon.js

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_sleep = require("./sleep-DQ586nj1.js");
+const require_sleep = require("./sleep-C9nrFlOu.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-BV7rLc6Y.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-_J5S7OEP.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/index.js

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_sleep = require("./sleep-DQ586nj1.js");
+const require_sleep = require("./sleep-C9nrFlOu.js");
 const require_err_msg = require("./err-msg-COpsHMw2.js");
 let zod = require("zod");
 //#region src/health/wiring-health.ts

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-BV7rLc6Y.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-_J5S7OEP.mjs";
 import { t as errMsg } from "./err-msg-IQTHeDzc.mjs";
 import { z } from "zod";
 //#region src/health/wiring-health.ts

package/dist/interfaces/addon.d.ts

@@ -395,10 +395,17 @@ export interface AddonContext<TConfig = Record<string, unknown>> {
     readonly addonConfig: Readonly<TConfig>;
     /**
      * Private data directory for this addon.
-     * Resolved via storageProvider.resolve('addons-data', '{addonId}/').
-     * The addon owns this directory exclusively.
+     * `<nodeDataDir>/addons-data/{addonId}` — the addon owns it exclusively.
      */
     readonly dataDir: string;
+    /**
+     * Node-local data ROOT for this node (`CAMSTACK_DATA` ?? the kernel boot dir).
+     * The single, centralized anchor for internal per-node working directories
+     * (models, logs, addons-data). Always writable on the local node — unlike the
+     * hub-singleton `storage` cap, which returns the hub's path to every node.
+     * Use this (never `api.storage.resolve`) for internal node-local dirs.
+     */
+    readonly nodeDataDir: string;
     /** Infrastructure services provided by the kernel. */
     readonly kernel: IKernelServices;
     /**

package/dist/{sleep-DQ586nj1.js → sleep-C9nrFlOu.js}

@@ -1211,15 +1211,24 @@ var BaseAddon = class {
 		} catch {}
 	}
 	/**
-	* Resolve the shared models directory path via the storage capability.
-	* Falls back to `camstack-data/models` if storage is unavailable.
-	* Used by inference addons (detection-pipeline, audio-classifier, embedding-encoder).
+	* Resolve the shared, node-local models directory: `<nodeDataDir>/models`.
+	*
+	* This is the SINGLE centralized models-dir resolver for every inference addon
+	* (detection-pipeline, audio-analyzer, embedding-encoder, model-studio). It is
+	* anchored at the node's own writable data root (`ctx.nodeDataDir`, i.e.
+	* `CAMSTACK_DATA` ?? the kernel boot dir) — never the hub-singleton `storage`
+	* cap, which returns the hub's `/data/models` to every node and breaks any node
+	* whose real data dir differs (e.g. the macOS electron agent).
+	*
+	* `node:path`/`node:fs` are imported dynamically so the `@camstack/types` root
+	* barrel (re-exported into browser bundles) stays free of node builtins.
 	*/
 	async resolveModelsDir() {
-		return this.ctx.api.storage.resolve.query({
-			location: "models",
-			relativePath: ""
-		}).catch(() => "camstack-data/models");
+		const { join } = await import("node:path");
+		const { promises: fsp } = await import("node:fs");
+		const dir = join(this.ctx.nodeDataDir, "models");
+		await fsp.mkdir(dir, { recursive: true });
+		return dir;
 	}
 	/**
 	* Access the runtime capability registry for in-process provider lookups.

package/dist/{sleep-BV7rLc6Y.mjs → sleep-_J5S7OEP.mjs}

@@ -1211,15 +1211,24 @@ var BaseAddon = class {
 		} catch {}
 	}
 	/**
-	* Resolve the shared models directory path via the storage capability.
-	* Falls back to `camstack-data/models` if storage is unavailable.
-	* Used by inference addons (detection-pipeline, audio-classifier, embedding-encoder).
+	* Resolve the shared, node-local models directory: `<nodeDataDir>/models`.
+	*
+	* This is the SINGLE centralized models-dir resolver for every inference addon
+	* (detection-pipeline, audio-analyzer, embedding-encoder, model-studio). It is
+	* anchored at the node's own writable data root (`ctx.nodeDataDir`, i.e.
+	* `CAMSTACK_DATA` ?? the kernel boot dir) — never the hub-singleton `storage`
+	* cap, which returns the hub's `/data/models` to every node and breaks any node
+	* whose real data dir differs (e.g. the macOS electron agent).
+	*
+	* `node:path`/`node:fs` are imported dynamically so the `@camstack/types` root
+	* barrel (re-exported into browser bundles) stays free of node builtins.
 	*/
 	async resolveModelsDir() {
-		return this.ctx.api.storage.resolve.query({
-			location: "models",
-			relativePath: ""
-		}).catch(() => "camstack-data/models");
+		const { join } = await import("node:path");
+		const { promises: fsp } = await import("node:fs");
+		const dir = join(this.ctx.nodeDataDir, "models");
+		await fsp.mkdir(dir, { recursive: true });
+		return dir;
 	}
 	/**
 	* Access the runtime capability registry for in-process provider lookups.

package/package.json

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