@camstack/addon-ai 0.4.119 → 0.4.121

package/dist/addon.js

@@ -5520,7 +5520,7 @@ function number(params) {
 	return /* @__PURE__ */ _coercedNumber(ZodNumber, params);
 }
 //#endregion
-//#region ../types/dist/sleep-vl6nBE8d.mjs
+//#region ../types/dist/sleep-Bs3xPtSh.mjs
 /**
 * The audio chunk plane's byte format, and the ONE expansion from a coded
 * window to float samples (D455).
@@ -12024,6 +12024,24 @@ var GetStreamWithCodecInputSchema = object({
 });
 var RtpSourceSchema = object({
 	url: string(),
+	/**
+	* The SENTRY counterpart of {@link url} — the dial that asks for the stream
+	* WITHOUT asking for the camera — or `null` when this camera offers none.
+	*
+	* The broker answers it because the broker is the only thing that can:
+	* eligibility is `sentryEligible` (a BATTERY camera that DECLARES the signals
+	* cap), asked of facts only the broker holds. A consumer re-deriving it from
+	* cap bindings would be a second authority, and two authorities on the same
+	* question is how a composite camera ends up dialling a sleeping camera
+	* because its own copy of the rule was a release behind.
+	*
+	* `null` is a real answer and is never a live url in disguise: a consumer
+	* that silently fell back to {@link url} would perform exactly the wake this
+	* field exists to prevent. Only a PASSTHROUGH acquisition can offer one — a
+	* transcode hands back an egress the broker is feeding itself, which has no
+	* sentry counterpart.
+	*/
+	sentryUrl: string().nullable().optional(),
 	videoCodec: _enum(["H264", "H265"]),
 	audioCodec: string(),
 	resolution: object({
@@ -27460,6 +27478,114 @@ DeviceType.Light, DeviceType.Siren, DeviceType.Switch, method(object({
 	lastChangedAt: number$1()
 });
 /**
+* camera-grid-layout — the geometry of a COMPOSITE camera, on the camera's own
+* page.
+*
+* ## Why this is a capability and not an addon settings schema
+*
+* It was one, and it did not render. The addon declared the editor as a
+* `type: 'widget'` field inside its own `deviceSettingsSchema()`; the hub
+* returned that section correctly and `ConfigFormField` renders `type:'widget'`
+* perfectly well — and nothing ever asked camera-grid for it. The Cluster →
+* Pipeline → Device Overrides page interrogates a HAND-WRITTEN list of four
+* addons (`PIPELINE_CLUSTER_DEVICE_ADDONS`), whose own comment says an addon
+* not on it "falls off silently".
+*
+* Adding a fifth name to that list would have been the wrong fix twice over:
+* that page is per-camera DETECTION tuning, and a grid's geometry belongs
+* beside PTZ and motion zones on the camera itself — which is exactly where the
+* framework already puts a widget, when the widget is declared on a CAPABILITY.
+* `deviceConfig.ui` is the mechanism (`motion-zones`, `ptz`, `ptz-autotrack`
+* all use it): the framework emits the structural section and the widget
+* self-persists through the cap's own mutations.
+*
+* ## Why one addon may implement it
+*
+* It is a device-scoped NATIVE cap, registered by the grid camera device
+* itself. Nothing else declares a composite camera, so nothing else has a
+* layout — and the device-scoped route means the widget asks THE camera, not
+* "the camera-grid addon", which is what let the old custom-action pair be
+* reached only by a caller that already knew the addon id.
+*
+* ## The tab
+*
+* `streaming`, not a top-tab of its own. A grid's geometry IS what its stream
+* is, so the Streaming tab is where it belongs; a `grid` top-tab would need an
+* entry in `WELL_KNOWN_TAB_MAP` or the device page renders the raw id as the
+* label (measured on the robot camera, 2026-09-06 — a tab called "navigation"
+* next to "PTZ").
+*/
+/** A rectangle in normalized [0,1] coordinates of whatever contains it. */
+var GridNormalizedRectSchema = object({
+	x: number$1().min(0).max(1),
+	y: number$1().min(0).max(1),
+	width: number$1().gt(0).max(1),
+	height: number$1().gt(0).max(1)
+});
+/**
+* One source camera, the part of its picture taken, and where that part lands.
+*
+* Both rectangles are NORMALIZED (D519): a source camera can change resolution
+* — a profile switch, a firmware update, a substream that comes back different
+* — and a stored PIXEL rectangle would quietly start cutting the wrong region,
+* which is the class of bug nobody files.
+*/
+var GridLayoutCellSchema = object({
+	deviceId: number$1().int().positive(),
+	/** The part of the SOURCE taken, normalized against the source. */
+	source: GridNormalizedRectSchema,
+	/** Where it lands, normalized against the CANVAS. */
+	cell: GridNormalizedRectSchema
+});
+/**
+* Which profiles this grid can actually compose, and why not.
+*
+* A grid's `high` composes its sources' `high` and its `low` their `low`, so a
+* profile is on offer only when EVERY source can serve it. The refusal NAMES
+* the sources, because "this grid has no low" is not a finding — "615 has no
+* low" is, and it is the one an operator can act on.
+*/
+var GridProfileOfferSchema = object({
+	profile: _enum([
+		"high",
+		"mid",
+		"low"
+	]),
+	offered: boolean(),
+	/** Sources that cannot serve it. Empty when it is offered, or when there are no cells. */
+	missingSources: array(number$1().int().positive())
+});
+var GridLayoutViewSchema = object({
+	/** The persisted grid row this camera was declared from. */
+	instanceId: string(),
+	deviceId: number$1().int().nonnegative(),
+	name: string(),
+	/** The canvas the operator laid out — this grid's `high`. mid/low are scaled from it. */
+	width: number$1().int(),
+	height: number$1().int(),
+	fps: number$1().int(),
+	cells: array(GridLayoutCellSchema),
+	/** What the catalog will publish, and what it refuses to. Read-only. */
+	profiles: array(GridProfileOfferSchema)
+});
+var GridLayoutPatchSchema = object({
+	deviceId: number$1().int().nonnegative(),
+	name: string().min(1).max(160).optional(),
+	width: number$1().int().min(160).max(7680).optional(),
+	height: number$1().int().min(120).max(4320).optional(),
+	fps: number$1().int().min(1).max(60).optional(),
+	/**
+	* The whole cell list at once. A per-cell patch would need an ordering the
+	* editor does not have, and a half-applied layout is a picture nobody asked
+	* for.
+	*/
+	cells: array(GridLayoutCellSchema).max(16)
+});
+DeviceType.Camera, method(object({ deviceId: number$1().int().nonnegative() }), GridLayoutViewSchema.nullable(), { auth: "admin" }), method(GridLayoutPatchSchema, GridLayoutViewSchema, {
+	kind: "mutation",
+	auth: "admin"
+});
+/**
 * Motion-zones share the same MaskShape vocabulary as privacy-mask — the
 * on-camera motion-detection mask is a single `grid` region (a row-major
 * boolean cell lattice the camera's onboard VMD evaluates). Composing it as
@@ -29159,6 +29285,26 @@ var PtzHomePresetSchema = object({
 		"none"
 	])
 });
+/**
+* The camera's own idle-return behaviour: whether it goes home by itself, and
+* after how long.
+*
+* ONE shape, not two scalars, because on the camera they are ONE fact —
+* Reolink's guard point carries `benable` and `timeout` in the same element,
+* written by the same command. Reading them apart means two round-trips that
+* can disagree.
+*
+* `enabled` and `seconds` are INDEPENDENT: a camera can hold a 68 s delay with
+* the behaviour switched off, which is exactly what the vendor app leaves when
+* you turn the guard point off without clearing it. The first version of this
+* cap reported only the delay, so that state was invisible — a camera could be
+* configured to return after 68 seconds with no way to say whether it should
+* return at all.
+*/
+var PtzHomeReturnSchema = object({
+	enabled: boolean(),
+	seconds: number$1().int()
+});
 DeviceType.Camera, method(PtzMoveCommandSchema.extend({ deviceId: number$1() }), _void(), { kind: "mutation" }), method(PtzMoveCommandSchema.extend({ deviceId: number$1() }), _void(), { kind: "mutation" }), method(object({ deviceId: number$1() }), _void(), { kind: "mutation" }), method(object({ deviceId: number$1() }), array(PtzPresetSchema)), method(object({
 	deviceId: number$1(),
 	presetId: string()
@@ -29184,8 +29330,9 @@ DeviceType.Camera, method(PtzMoveCommandSchema.extend({ deviceId: number$1() }),
 }), method(object({ deviceId: number$1() }), _void(), {
 	kind: "mutation",
 	auth: "admin"
-}), method(object({ deviceId: number$1() }), number$1().int().nullable()), method(object({
+}), method(object({ deviceId: number$1() }), PtzHomeReturnSchema.nullable()), method(object({
 	deviceId: number$1(),
+	enabled: boolean(),
 	seconds: number$1().int().min(0).max(3600)
 }), _void(), {
 	kind: "mutation",
@@ -32467,6 +32614,18 @@ Object.freeze({
 		addonId: null,
 		access: "view"
 	},
+	"cameraGridLayout.getLayout": {
+		capName: "camera-grid-layout",
+		capScope: "device",
+		addonId: null,
+		access: "view"
+	},
+	"cameraGridLayout.saveLayout": {
+		capName: "camera-grid-layout",
+		capScope: "device",
+		addonId: null,
+		access: "create"
+	},
 	"cameraStreams.getBrokerStreams": {
 		capName: "camera-streams",
 		capScope: "device",
@@ -36217,7 +36376,7 @@ Object.freeze({
 		addonId: null,
 		access: "view"
 	},
-	"ptz.getHomeReturnSeconds": {
+	"ptz.getHomeReturn": {
 		capName: "ptz",
 		capScope: "device",
 		addonId: null,
@@ -36277,7 +36436,7 @@ Object.freeze({
 		addonId: null,
 		access: "create"
 	},
-	"ptz.setHomeReturnSeconds": {
+	"ptz.setHomeReturn": {
 		capName: "ptz",
 		capScope: "device",
 		addonId: null,
@@ -38166,6 +38325,21 @@ Object.freeze({
 		form: "single",
 		optional: false
 	}],
+	"cameraGridLayout.getLayout": [{
+		name: "deviceId",
+		form: "single",
+		optional: false
+	}],
+	"cameraGridLayout.saveLayout": [{
+		name: "cells",
+		form: "object-array",
+		optional: false,
+		itemField: "deviceId"
+	}, {
+		name: "deviceId",
+		form: "single",
+		optional: false
+	}],
 	"cameraStreams.getBrokerStreams": [{
 		name: "deviceId",
 		form: "single",
@@ -39466,7 +39640,7 @@ Object.freeze({
 		form: "single",
 		optional: false
 	}],
-	"ptz.getHomeReturnSeconds": [{
+	"ptz.getHomeReturn": [{
 		name: "deviceId",
 		form: "single",
 		optional: false
@@ -39516,7 +39690,7 @@ Object.freeze({
 		form: "single",
 		optional: false
 	}],
-	"ptz.setHomeReturnSeconds": [{
+	"ptz.setHomeReturn": [{
 		name: "deviceId",
 		form: "single",
 		optional: false

package/dist/addon.mjs

@@ -5547,7 +5547,7 @@ function number(params) {
 	return /* @__PURE__ */ _coercedNumber(ZodNumber, params);
 }
 //#endregion
-//#region ../types/dist/sleep-vl6nBE8d.mjs
+//#region ../types/dist/sleep-Bs3xPtSh.mjs
 /**
 * The audio chunk plane's byte format, and the ONE expansion from a coded
 * window to float samples (D455).
@@ -12051,6 +12051,24 @@ var GetStreamWithCodecInputSchema = object({
 });
 var RtpSourceSchema = object({
 	url: string(),
+	/**
+	* The SENTRY counterpart of {@link url} — the dial that asks for the stream
+	* WITHOUT asking for the camera — or `null` when this camera offers none.
+	*
+	* The broker answers it because the broker is the only thing that can:
+	* eligibility is `sentryEligible` (a BATTERY camera that DECLARES the signals
+	* cap), asked of facts only the broker holds. A consumer re-deriving it from
+	* cap bindings would be a second authority, and two authorities on the same
+	* question is how a composite camera ends up dialling a sleeping camera
+	* because its own copy of the rule was a release behind.
+	*
+	* `null` is a real answer and is never a live url in disguise: a consumer
+	* that silently fell back to {@link url} would perform exactly the wake this
+	* field exists to prevent. Only a PASSTHROUGH acquisition can offer one — a
+	* transcode hands back an egress the broker is feeding itself, which has no
+	* sentry counterpart.
+	*/
+	sentryUrl: string().nullable().optional(),
 	videoCodec: _enum(["H264", "H265"]),
 	audioCodec: string(),
 	resolution: object({
@@ -27487,6 +27505,114 @@ DeviceType.Light, DeviceType.Siren, DeviceType.Switch, method(object({
 	lastChangedAt: number$1()
 });
 /**
+* camera-grid-layout — the geometry of a COMPOSITE camera, on the camera's own
+* page.
+*
+* ## Why this is a capability and not an addon settings schema
+*
+* It was one, and it did not render. The addon declared the editor as a
+* `type: 'widget'` field inside its own `deviceSettingsSchema()`; the hub
+* returned that section correctly and `ConfigFormField` renders `type:'widget'`
+* perfectly well — and nothing ever asked camera-grid for it. The Cluster →
+* Pipeline → Device Overrides page interrogates a HAND-WRITTEN list of four
+* addons (`PIPELINE_CLUSTER_DEVICE_ADDONS`), whose own comment says an addon
+* not on it "falls off silently".
+*
+* Adding a fifth name to that list would have been the wrong fix twice over:
+* that page is per-camera DETECTION tuning, and a grid's geometry belongs
+* beside PTZ and motion zones on the camera itself — which is exactly where the
+* framework already puts a widget, when the widget is declared on a CAPABILITY.
+* `deviceConfig.ui` is the mechanism (`motion-zones`, `ptz`, `ptz-autotrack`
+* all use it): the framework emits the structural section and the widget
+* self-persists through the cap's own mutations.
+*
+* ## Why one addon may implement it
+*
+* It is a device-scoped NATIVE cap, registered by the grid camera device
+* itself. Nothing else declares a composite camera, so nothing else has a
+* layout — and the device-scoped route means the widget asks THE camera, not
+* "the camera-grid addon", which is what let the old custom-action pair be
+* reached only by a caller that already knew the addon id.
+*
+* ## The tab
+*
+* `streaming`, not a top-tab of its own. A grid's geometry IS what its stream
+* is, so the Streaming tab is where it belongs; a `grid` top-tab would need an
+* entry in `WELL_KNOWN_TAB_MAP` or the device page renders the raw id as the
+* label (measured on the robot camera, 2026-09-06 — a tab called "navigation"
+* next to "PTZ").
+*/
+/** A rectangle in normalized [0,1] coordinates of whatever contains it. */
+var GridNormalizedRectSchema = object({
+	x: number$1().min(0).max(1),
+	y: number$1().min(0).max(1),
+	width: number$1().gt(0).max(1),
+	height: number$1().gt(0).max(1)
+});
+/**
+* One source camera, the part of its picture taken, and where that part lands.
+*
+* Both rectangles are NORMALIZED (D519): a source camera can change resolution
+* — a profile switch, a firmware update, a substream that comes back different
+* — and a stored PIXEL rectangle would quietly start cutting the wrong region,
+* which is the class of bug nobody files.
+*/
+var GridLayoutCellSchema = object({
+	deviceId: number$1().int().positive(),
+	/** The part of the SOURCE taken, normalized against the source. */
+	source: GridNormalizedRectSchema,
+	/** Where it lands, normalized against the CANVAS. */
+	cell: GridNormalizedRectSchema
+});
+/**
+* Which profiles this grid can actually compose, and why not.
+*
+* A grid's `high` composes its sources' `high` and its `low` their `low`, so a
+* profile is on offer only when EVERY source can serve it. The refusal NAMES
+* the sources, because "this grid has no low" is not a finding — "615 has no
+* low" is, and it is the one an operator can act on.
+*/
+var GridProfileOfferSchema = object({
+	profile: _enum([
+		"high",
+		"mid",
+		"low"
+	]),
+	offered: boolean(),
+	/** Sources that cannot serve it. Empty when it is offered, or when there are no cells. */
+	missingSources: array(number$1().int().positive())
+});
+var GridLayoutViewSchema = object({
+	/** The persisted grid row this camera was declared from. */
+	instanceId: string(),
+	deviceId: number$1().int().nonnegative(),
+	name: string(),
+	/** The canvas the operator laid out — this grid's `high`. mid/low are scaled from it. */
+	width: number$1().int(),
+	height: number$1().int(),
+	fps: number$1().int(),
+	cells: array(GridLayoutCellSchema),
+	/** What the catalog will publish, and what it refuses to. Read-only. */
+	profiles: array(GridProfileOfferSchema)
+});
+var GridLayoutPatchSchema = object({
+	deviceId: number$1().int().nonnegative(),
+	name: string().min(1).max(160).optional(),
+	width: number$1().int().min(160).max(7680).optional(),
+	height: number$1().int().min(120).max(4320).optional(),
+	fps: number$1().int().min(1).max(60).optional(),
+	/**
+	* The whole cell list at once. A per-cell patch would need an ordering the
+	* editor does not have, and a half-applied layout is a picture nobody asked
+	* for.
+	*/
+	cells: array(GridLayoutCellSchema).max(16)
+});
+DeviceType.Camera, method(object({ deviceId: number$1().int().nonnegative() }), GridLayoutViewSchema.nullable(), { auth: "admin" }), method(GridLayoutPatchSchema, GridLayoutViewSchema, {
+	kind: "mutation",
+	auth: "admin"
+});
+/**
 * Motion-zones share the same MaskShape vocabulary as privacy-mask — the
 * on-camera motion-detection mask is a single `grid` region (a row-major
 * boolean cell lattice the camera's onboard VMD evaluates). Composing it as
@@ -29186,6 +29312,26 @@ var PtzHomePresetSchema = object({
 		"none"
 	])
 });
+/**
+* The camera's own idle-return behaviour: whether it goes home by itself, and
+* after how long.
+*
+* ONE shape, not two scalars, because on the camera they are ONE fact —
+* Reolink's guard point carries `benable` and `timeout` in the same element,
+* written by the same command. Reading them apart means two round-trips that
+* can disagree.
+*
+* `enabled` and `seconds` are INDEPENDENT: a camera can hold a 68 s delay with
+* the behaviour switched off, which is exactly what the vendor app leaves when
+* you turn the guard point off without clearing it. The first version of this
+* cap reported only the delay, so that state was invisible — a camera could be
+* configured to return after 68 seconds with no way to say whether it should
+* return at all.
+*/
+var PtzHomeReturnSchema = object({
+	enabled: boolean(),
+	seconds: number$1().int()
+});
 DeviceType.Camera, method(PtzMoveCommandSchema.extend({ deviceId: number$1() }), _void(), { kind: "mutation" }), method(PtzMoveCommandSchema.extend({ deviceId: number$1() }), _void(), { kind: "mutation" }), method(object({ deviceId: number$1() }), _void(), { kind: "mutation" }), method(object({ deviceId: number$1() }), array(PtzPresetSchema)), method(object({
 	deviceId: number$1(),
 	presetId: string()
@@ -29211,8 +29357,9 @@ DeviceType.Camera, method(PtzMoveCommandSchema.extend({ deviceId: number$1() }),
 }), method(object({ deviceId: number$1() }), _void(), {
 	kind: "mutation",
 	auth: "admin"
-}), method(object({ deviceId: number$1() }), number$1().int().nullable()), method(object({
+}), method(object({ deviceId: number$1() }), PtzHomeReturnSchema.nullable()), method(object({
 	deviceId: number$1(),
+	enabled: boolean(),
 	seconds: number$1().int().min(0).max(3600)
 }), _void(), {
 	kind: "mutation",
@@ -32494,6 +32641,18 @@ Object.freeze({
 		addonId: null,
 		access: "view"
 	},
+	"cameraGridLayout.getLayout": {
+		capName: "camera-grid-layout",
+		capScope: "device",
+		addonId: null,
+		access: "view"
+	},
+	"cameraGridLayout.saveLayout": {
+		capName: "camera-grid-layout",
+		capScope: "device",
+		addonId: null,
+		access: "create"
+	},
 	"cameraStreams.getBrokerStreams": {
 		capName: "camera-streams",
 		capScope: "device",
@@ -36244,7 +36403,7 @@ Object.freeze({
 		addonId: null,
 		access: "view"
 	},
-	"ptz.getHomeReturnSeconds": {
+	"ptz.getHomeReturn": {
 		capName: "ptz",
 		capScope: "device",
 		addonId: null,
@@ -36304,7 +36463,7 @@ Object.freeze({
 		addonId: null,
 		access: "create"
 	},
-	"ptz.setHomeReturnSeconds": {
+	"ptz.setHomeReturn": {
 		capName: "ptz",
 		capScope: "device",
 		addonId: null,
@@ -38193,6 +38352,21 @@ Object.freeze({
 		form: "single",
 		optional: false
 	}],
+	"cameraGridLayout.getLayout": [{
+		name: "deviceId",
+		form: "single",
+		optional: false
+	}],
+	"cameraGridLayout.saveLayout": [{
+		name: "cells",
+		form: "object-array",
+		optional: false,
+		itemField: "deviceId"
+	}, {
+		name: "deviceId",
+		form: "single",
+		optional: false
+	}],
 	"cameraStreams.getBrokerStreams": [{
 		name: "deviceId",
 		form: "single",
@@ -39493,7 +39667,7 @@ Object.freeze({
 		form: "single",
 		optional: false
 	}],
-	"ptz.getHomeReturnSeconds": [{
+	"ptz.getHomeReturn": [{
 		name: "deviceId",
 		form: "single",
 		optional: false
@@ -39543,7 +39717,7 @@ Object.freeze({
 		form: "single",
 		optional: false
 	}],
-	"ptz.setHomeReturnSeconds": [{
+	"ptz.setHomeReturn": [{
 		name: "deviceId",
 		form: "single",
 		optional: false

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@camstack/addon-ai",
-  "version": "0.4.119",
+  "version": "0.4.121",
   "description": "AI addon for CamStack — the `llm` collection provider (cloud, LAN, and camstack-managed local llama.cpp profiles) plus the per-node `llm-runtime` managed executor.",
   "keywords": [
     "camstack",