@camstack/addon-post-analysis 1.1.3 → 1.1.5

package/dist/{dist-BUE-vLMt.mjs → dist-BpGP9ago.mjs}

@@ -4627,7 +4627,7 @@ function _instanceof(cls, params = {}) {
 	return inst;
 }
 //#endregion
-//#region ../types/dist/sleep-BV7rLc6Y.mjs
+//#region ../types/dist/sleep-NOH4yRwj.mjs
 var EventCategory = /* @__PURE__ */ function(EventCategory) {
 	EventCategory["SystemBoot"] = "system.boot";
 	EventCategory["SystemAddonsReady"] = "system.addons-ready";
@@ -5742,15 +5742,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.
@@ -7125,6 +7134,9 @@ var EncodeProfileSchema = object({
 	*/
 	outputArgs: array(string()).optional()
 });
+function hfModelUrl(repo, path) {
+	return `https://huggingface.co/${repo}/resolve/main/${path}`;
+}
 /** Cosine similarity between two embedding vectors */
 function cosineSimilarity(a, b) {
 	if (a.length !== b.length) return 0;
@@ -12761,7 +12773,8 @@ method(object({
 	sessionId: string().optional()
 }), ConvertResultSchema, {
 	kind: "mutation",
-	auth: "admin"
+	auth: "admin",
+	timeoutMs: 6e5
 });
 var AddonHttpRouteSchema = object({
 	method: _enum([
@@ -14317,7 +14330,14 @@ var NotificationRuleConditionsSchema = object({
 	/** Match against `event.data.eventType` token (e.g. `'press_long'`). When non-empty, only events
 	*  carrying a matching `data.eventType` string pass this condition. Rules without this field are
 	*  unaffected (back-compat). Distinct from `rule.eventTypes` which holds EventCategory strings. */
-	eventTypeTokens: array(string()).readonly().optional()
+	eventTypeTokens: array(string()).readonly().optional(),
+	/** Match detections whose CLIP image embedding is semantically similar to this free-text
+	*  description. Requires the embedding-encoder cap to have pre-warmed the text vector.
+	*  `minSimilarity` is the cosine similarity threshold in [0, 1]. */
+	clipDescription: object({
+		text: string().min(1),
+		minSimilarity: number().min(0).max(1)
+	}).optional()
 });
 var NotificationRuleTemplateSchema = object({
 	title: string(),
@@ -14559,6 +14579,16 @@ var TrackedDetectionSchema = object({
 	zones: array(string()).readonly(),
 	state: TrackStateSchema
 });
+var ScoredObjectEventSchema = ObjectEventSchema.extend({ score: number() });
+var SearchObjectEventsInput = object({
+	text: string(),
+	deviceId: number().optional(),
+	since: number().optional(),
+	until: number().optional(),
+	classFilter: string().optional(),
+	limit: number().default(50),
+	minScore: number().min(0).max(1).default(.2)
+});
 var pipelineAnalyticsCapability = {
 	name: "pipeline-analytics",
 	scope: "device",
@@ -14625,7 +14655,16 @@ var pipelineAnalyticsCapability = {
 			eventId: string(),
 			kind: MediaFileKindEnum.optional()
 		}), array(MediaFileSchema).readonly()),
-		getTrackMedia: method(object({ trackId: string() }), array(MediaFileSchema).readonly())
+		getTrackMedia: method(object({ trackId: string() }), array(MediaFileSchema).readonly()),
+		/**
+		* Search object events by text query using CLIP cosine similarity.
+		* Encodes `text` via the `embedding-encoder` cap, queries the
+		* `ObjectEmbeddingStore` with optional prefilters, ranks all matching
+		* embeddings by cosine similarity, and joins winners to their
+		* ObjectEvents by trackId. Returns up to `limit` events scored ≥
+		* `minScore`, sorted descending by score.
+		*/
+		searchObjectEvents: method(SearchObjectEventsInput, array(ScoredObjectEventSchema).readonly())
 	},
 	events: {
 		/**
@@ -19342,6 +19381,12 @@ Object.freeze({
 		addonId: null,
 		access: "create"
 	},
+	"pipelineAnalytics.searchObjectEvents": {
+		capName: "pipeline-analytics",
+		capScope: "device",
+		addonId: null,
+		access: "view"
+	},
 	"pipelineExecutor.cacheFrameInPool": {
 		capName: "pipeline-executor",
 		capScope: "system",
@@ -21226,4 +21271,4 @@ object({
 	schemaVersion: literal(1)
 });
 //#endregion
-export { tuple as C, string as S, _enum as _, faceGalleryCapability as a, number as b, videoclipsCapability as c, BaseAddon as d, DeviceType as f, hydrateSchema as g, createEvent as h, embeddingEncoderCapability as i, zoneAnalyticsCapability as l, asJsonObject as m, audioMetricsCapability as n, pipelineAnalyticsCapability as o, EventCategory as p, cosineSimilarity as r, plateGalleryCapability as s, addonWidgetsSourceCapability as t, errMsg as u, array as v, object as x, boolean as y };
+export { string as C, object as S, hydrateSchema as _, faceGalleryCapability as a, boolean as b, plateGalleryCapability as c, errMsg as d, BaseAddon as f, createEvent as g, asJsonObject as h, embeddingEncoderCapability as i, videoclipsCapability as l, EventCategory as m, audioMetricsCapability as n, hfModelUrl as o, DeviceType as p, cosineSimilarity as r, pipelineAnalyticsCapability as s, addonWidgetsSourceCapability as t, zoneAnalyticsCapability as u, _enum as v, tuple as w, number as x, array as y };

package/dist/{dist-BY1NQ5oi.js → dist-n-zJ0Uox.js}

@@ -4649,7 +4649,7 @@ function _instanceof(cls, params = {}) {
 	return inst;
 }
 //#endregion
-//#region ../types/dist/sleep-BV7rLc6Y.mjs
+//#region ../types/dist/sleep-NOH4yRwj.mjs
 var EventCategory = /* @__PURE__ */ function(EventCategory) {
 	EventCategory["SystemBoot"] = "system.boot";
 	EventCategory["SystemAddonsReady"] = "system.addons-ready";
@@ -5764,15 +5764,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.
@@ -7147,6 +7156,9 @@ var EncodeProfileSchema = object({
 	*/
 	outputArgs: array(string()).optional()
 });
+function hfModelUrl(repo, path) {
+	return `https://huggingface.co/${repo}/resolve/main/${path}`;
+}
 /** Cosine similarity between two embedding vectors */
 function cosineSimilarity(a, b) {
 	if (a.length !== b.length) return 0;
@@ -12783,7 +12795,8 @@ method(object({
 	sessionId: string().optional()
 }), ConvertResultSchema, {
 	kind: "mutation",
-	auth: "admin"
+	auth: "admin",
+	timeoutMs: 6e5
 });
 var AddonHttpRouteSchema = object({
 	method: _enum([
@@ -14339,7 +14352,14 @@ var NotificationRuleConditionsSchema = object({
 	/** Match against `event.data.eventType` token (e.g. `'press_long'`). When non-empty, only events
 	*  carrying a matching `data.eventType` string pass this condition. Rules without this field are
 	*  unaffected (back-compat). Distinct from `rule.eventTypes` which holds EventCategory strings. */
-	eventTypeTokens: array(string()).readonly().optional()
+	eventTypeTokens: array(string()).readonly().optional(),
+	/** Match detections whose CLIP image embedding is semantically similar to this free-text
+	*  description. Requires the embedding-encoder cap to have pre-warmed the text vector.
+	*  `minSimilarity` is the cosine similarity threshold in [0, 1]. */
+	clipDescription: object({
+		text: string().min(1),
+		minSimilarity: number().min(0).max(1)
+	}).optional()
 });
 var NotificationRuleTemplateSchema = object({
 	title: string(),
@@ -14581,6 +14601,16 @@ var TrackedDetectionSchema = object({
 	zones: array(string()).readonly(),
 	state: TrackStateSchema
 });
+var ScoredObjectEventSchema = ObjectEventSchema.extend({ score: number() });
+var SearchObjectEventsInput = object({
+	text: string(),
+	deviceId: number().optional(),
+	since: number().optional(),
+	until: number().optional(),
+	classFilter: string().optional(),
+	limit: number().default(50),
+	minScore: number().min(0).max(1).default(.2)
+});
 var pipelineAnalyticsCapability = {
 	name: "pipeline-analytics",
 	scope: "device",
@@ -14647,7 +14677,16 @@ var pipelineAnalyticsCapability = {
 			eventId: string(),
 			kind: MediaFileKindEnum.optional()
 		}), array(MediaFileSchema).readonly()),
-		getTrackMedia: method(object({ trackId: string() }), array(MediaFileSchema).readonly())
+		getTrackMedia: method(object({ trackId: string() }), array(MediaFileSchema).readonly()),
+		/**
+		* Search object events by text query using CLIP cosine similarity.
+		* Encodes `text` via the `embedding-encoder` cap, queries the
+		* `ObjectEmbeddingStore` with optional prefilters, ranks all matching
+		* embeddings by cosine similarity, and joins winners to their
+		* ObjectEvents by trackId. Returns up to `limit` events scored ≥
+		* `minScore`, sorted descending by score.
+		*/
+		searchObjectEvents: method(SearchObjectEventsInput, array(ScoredObjectEventSchema).readonly())
 	},
 	events: {
 		/**
@@ -19364,6 +19403,12 @@ Object.freeze({
 		addonId: null,
 		access: "create"
 	},
+	"pipelineAnalytics.searchObjectEvents": {
+		capName: "pipeline-analytics",
+		capScope: "device",
+		addonId: null,
+		access: "view"
+	},
 	"pipelineExecutor.cacheFrameInPool": {
 		capName: "pipeline-executor",
 		capScope: "system",
@@ -21338,6 +21383,12 @@ Object.defineProperty(exports, "faceGalleryCapability", {
 		return faceGalleryCapability;
 	}
 });
+Object.defineProperty(exports, "hfModelUrl", {
+	enumerable: true,
+	get: function() {
+		return hfModelUrl;
+	}
+});
 Object.defineProperty(exports, "hydrateSchema", {
 	enumerable: true,
 	get: function() {