@camstack/types 1.2.386 → 1.2.388

package/dist/client.mjs

@@ -23037,6 +23037,33 @@ var NcRuleTargetSchema = z.object({
 	params: z.record(z.string(), z.unknown()).optional()
 });
 /**
+* WHAT THE NOTIFICATION'S PICTURE IS (D897) — the ONE media choice of a rule.
+*
+* Every mode starts from the same CLEAN source frame of the trigger moment
+* (keyFrame → sceneFrame → lastSceneFrame, narrowed to the trigger instant and
+* to the zone that fired the rule) and renders it once at send time:
+*  - `scene-boxes` — the whole scene, the subject outlined thick in the accent
+*    colour and every OTHER track visible at that instant outlined thin, each
+*    labelled with class and confidence ("dog 87%").
+*  - `crop`  — the subject cut out of that frame around its box at that instant.
+*  - `clean` — the whole scene with nothing drawn on it.
+*  - `none`  — no picture.
+*
+* A mode that cannot be honoured (no box at that instant, a photograph with no
+* tracked subject) ships `clean` and names the reason in the log, per camera.
+* It replaces the `attach` × `frame` × `zoneCrop` triple, which let one rule
+* ship a crop on one event and a boxed scene on the next depending on which
+* stored kind had landed.
+*/
+var NcMediaImageSchema = z.enum([
+	"scene-boxes",
+	"crop",
+	"clean",
+	"none"
+]);
+/**
+* @deprecated Read only by `normalizeNcMediaPolicy` (D897) — see {@link NcMediaImageSchema}.
+*
 * Media attachment policy (P1 still-image subset).
 *  - `best` — the best AVAILABLE subject image at dispatch time (D-3).
 *  - `best-matching` — the media that explains WHY the rule fired: a rule
@@ -23050,6 +23077,8 @@ var NcRuleTargetSchema = z.object({
 *  - `none` — no attachment.
 */
 /**
+* @deprecated Read only by `normalizeNcMediaPolicy` (D897) — see {@link NcMediaImageSchema}.
+*
 * WHAT THE PICTURE SHOWS — chosen explicitly, because the implicit ladders
 * conflate it with the selection strategy and betray the request: asking for
 * the clean scene frame on an object-event owner used to start at
@@ -23078,16 +23107,29 @@ var NcMediaFrameSchema = z.enum([
 */
 var NcLinkedCameraModeSchema = z.enum(["mosaic", "each"]);
 var NcMediaPolicySchema = z.object({
+	/**
+	* The picture — see {@link NcMediaImageSchema}. Absent on a rule nobody has
+	* saved since D897: `normalizeNcMediaPolicy` derives it from the legacy
+	* triple below, at load and at every write, and the store keeps only this.
+	*/
+	image: NcMediaImageSchema.optional(),
+	/**
+	* Draw the zone that FIRED the rule on the picture (`scene-boxes` / `clean`;
+	* a `crop` never shows it). Valid only on a rule whose trigger is a zone —
+	* `conditions.zones` or an occupancy zone — and refused on save otherwise.
+	* Replaces `zoneCrop`.
+	*/
+	showTriggerZone: z.boolean().optional(),
+	/** @deprecated D897 — accepted from an editor that predates `image`, folded into it on save. */
 	attach: z.enum([
 		"best",
 		"best-matching",
 		"keyFrame",
 		"none"
-	]).default("best"),
-	/** What the still shows. Absent = `cropped` (the historical `best` shape). */
+	]).optional(),
+	/** @deprecated D897 — accepted from an editor that predates `image`, folded into it on save. */
 	frame: NcMediaFrameSchema.optional(),
-	/** Crop the attached still to the rule's condition-zone bbox (padded) —
-	*  "show me the ZONE", not the whole scene or the subject crop. */
+	/** @deprecated D897 — folded into `image: 'clean'` + `showTriggerZone` on save. */
 	zoneCrop: z.boolean().optional(),
 	/**
 	* Also attach a short GIF cut from the stream broker's clip ring around the
@@ -23272,7 +23314,9 @@ var NcRuleInputSchema = z.object({
 	* targets.
 	*/
 	targetUsers: z.array(z.string()).optional(),
-	media: NcMediaPolicySchema.default({ attach: "best" }),
+	/** Absent = the kind's default picture (`resolveNcMediaImage`): the subject crop for a
+	*  detection, the clean scene for a sensor or a sound. Set explicitly on save (D897). */
+	media: NcMediaPolicySchema.default({}),
 	throttle: NcThrottleSchema.default({
 		cooldownSec: 60,
 		scope: "rule-device"
@@ -24232,13 +24276,37 @@ var NcAlarmModeOpeningsSchema = z.object({
 	/** Covered devices whose state could not be read (D49): neither open nor closed. */
 	unknown: z.array(z.number().int())
 });
+/**
+* One alarm INPUT — a (rule, device) pair — the operator bypassed until the
+* next disarm ("Bypass this input until disarm" on a trigger notification, or
+* `nc.bypassAlarmInput`). Reported so an armed alarm with a silenced input
+* never looks fully armed (D62: off must never look like broken).
+*/
+var NcAlarmInputBypassViewSchema = z.object({
+	ruleId: z.string(),
+	/** The rule's current name (its frozen name when the rule is gone). */
+	ruleName: z.string(),
+	/** The input: the sensor of the match, else its camera. */
+	deviceId: z.number().int(),
+	/** The input's current name. */
+	name: z.string(),
+	/** When it was bypassed (ms epoch). */
+	since: z.number(),
+	/** Triggers from this input dropped since. */
+	dropped: z.number().int().min(0)
+});
 var NcAlarmLiveSchema = z.object({
 	state: AlarmStateSchema,
 	/** The mode being armed into (exit delay) or held; null when disarmed. */
 	targetMode: AlarmArmModeSchema.nullable(),
 	availableModes: z.array(AlarmArmModeSchema),
 	openings: z.array(NcAlarmModeOpeningsSchema),
-	exclusions: z.array(NcAlarmExclusionViewSchema)
+	exclusions: z.array(NcAlarmExclusionViewSchema),
+	/**
+	* Inputs bypassed for the rest of this arm session; cleared on disarm.
+	* Defaulted so an older hub answer still parses (as "none known").
+	*/
+	bypassedInputs: z.array(NcAlarmInputBypassViewSchema).default([])
 });
 var NcAlarmConfigSchema = z.object({
 	/**
@@ -27735,6 +27803,7 @@ function createSystemProxy(api) {
 		deviceHistory: {
 			listNodeSeries: (input) => dispatch("deviceHistory", "listNodeSeries", "query", input),
 			queryNode: (input) => dispatch("deviceHistory", "queryNode", "query", input),
+			queryMany: (input) => dispatch("deviceHistory", "queryMany", "query", input),
 			declareSeries: (input) => dispatch("deviceHistory", "declareSeries", "mutation", input),
 			record: (input) => dispatch("deviceHistory", "record", "mutation", input),
 			recordBuckets: (input) => dispatch("deviceHistory", "recordBuckets", "mutation", input),
@@ -27868,7 +27937,7 @@ function createSystemProxy(api) {
 			migrateRawSecrets: (input) => dispatch("llm", "migrateRawSecrets", "mutation", input),
 			deleteProfile: (input) => dispatch("llm", "deleteProfile", "mutation", input),
 			testProfile: (input) => dispatch("llm", "testProfile", "mutation", input),
-			listModels: (input) => dispatch("llm", "listModels", "query", input),
+			listModels: (input) => dispatch("llm", "listModels", "mutation", input),
 			getDefaults: (input) => dispatch("llm", "getDefaults", "query", input),
 			setDefault: (input) => dispatch("llm", "setDefault", "mutation", input),
 			getUsage: (input) => dispatch("llm", "getUsage", "query", input),
@@ -28312,10 +28381,6 @@ function createSystemProxy(api) {
 			validateCredentials: (input) => dispatch("userManagement", "validateCredentials", "mutation", input),
 			listApiKeys: (input) => dispatch("userManagement", "listApiKeys", "query", input),
 			revokeApiKey: (input) => dispatch("userManagement", "revokeApiKey", "mutation", input),
-			createScopedToken: (input) => dispatch("userManagement", "createScopedToken", "mutation", input),
-			revokeScopedToken: (input) => dispatch("userManagement", "revokeScopedToken", "mutation", input),
-			validateScopedToken: (input) => dispatch("userManagement", "validateScopedToken", "query", input),
-			listScopedTokens: (input) => dispatch("userManagement", "listScopedTokens", "query", input),
 			setupTotp: (input) => dispatch("userManagement", "setupTotp", "mutation", input),
 			confirmTotp: (input) => dispatch("userManagement", "confirmTotp", "mutation", input),
 			disableTotp: (input) => dispatch("userManagement", "disableTotp", "mutation", input),

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

@@ -294,9 +294,18 @@ export declare abstract class BaseDevice<T extends z.ZodObject<z.core.$ZodLooseS
      * Drivers can use the `getProbeFlags()` helper to read the flag bag
      * with a typed cast.
      *
+     * Answer what you KNOW. A plain array is read as the complete list only
+     * while this device is `online` and probed; return
+     * `accessoryChildrenUnknown(reason)` whenever you cannot know the list right
+     * now (no credentials, parent not connected, a failed or partial read) —
+     * the kernel then deletes nothing. Return `accessoryChildrenComplete(list)`
+     * to say "connected, and this is the complete list" explicitly. A shrink is
+     * deleted only after a second agreeing complete read on a later probe (D49;
+     * `packages/system/src/kernel/moleculer/accessory-prune-gate.ts`).
+     *
      * Default: no children.
      */
-    getAccessoryChildren(): readonly AccessoryChildSpec[];
+    getAccessoryChildren(): AccessoryChildrenAnswer;
     /**
      * Read the current feature-probe flag bag with a typed cast. Helper
      * for `getAccessoryChildren()` and `features` getters that derive
@@ -311,6 +320,30 @@ export declare abstract class BaseDevice<T extends z.ZodObject<z.core.$ZodLooseS
      */
     protected hasProbed(): boolean;
 }
+/** "I cannot know my accessory children right now" — the kernel prunes nothing. */
+export interface AccessoryChildrenUnknown {
+    readonly kind: 'unknown';
+    /** Why, for the log line (`no credentials`, `cloud not connected`, …). */
+    readonly reason: string;
+    /**
+     * Children known to exist even so (e.g. the core device of a cloud
+     * container): they are spawned, never used as the list to prune against.
+     */
+    readonly known?: readonly AccessoryChildSpec[];
+}
+/** "Connected, and this is the COMPLETE list" — the only answer a prune may follow. */
+export interface AccessoryChildrenComplete {
+    readonly kind: 'complete';
+    readonly children: readonly AccessoryChildSpec[];
+}
+export type AccessoryChildrenRead = AccessoryChildrenComplete | AccessoryChildrenUnknown;
+/**
+ * What `getAccessoryChildren()` may answer: a typed read, or a plain list
+ * (complete only while the parent is online and probed).
+ */
+export type AccessoryChildrenAnswer = readonly AccessoryChildSpec[] | AccessoryChildrenRead;
+export declare function accessoryChildrenUnknown(reason: string, known?: readonly AccessoryChildSpec[]): AccessoryChildrenUnknown;
+export declare function accessoryChildrenComplete(children: readonly AccessoryChildSpec[]): AccessoryChildrenComplete;
 /**
  * Specification for one accessory child a parent device wants the
  * kernel to auto-spawn. Returned from `BaseDevice.getAccessoryChildren()`.

package/dist/device/index.d.ts

@@ -1,6 +1,6 @@
 export { ACCESSORY_LABEL, AccessoryKind, type AccessoryKindValue, accessoryStableId, } from './accessory.js';
-export type { AccessoryChildSpec } from './base-device.js';
-export { BaseDevice } from './base-device.js';
+export type { AccessoryChildrenAnswer, AccessoryChildrenComplete, AccessoryChildrenRead, AccessoryChildrenUnknown, AccessoryChildSpec, } from './base-device.js';
+export { accessoryChildrenComplete, accessoryChildrenUnknown, BaseDevice } from './base-device.js';
 export type { DeviceRestoreReport, DeviceSummary, DiscoveryCandidate, FieldProbeResult, ProviderStatus, } from './base-device-provider.js';
 export { BaseDeviceProvider, toDeviceSummary } from './base-device-provider.js';
 export type { DeviceRestoreRetrySchedulerOptions, InitialRestoreFailure, PermanentRestoreFailure, PermanentRestoreFailureHandler, RestoreAttemptFn, } from './device-restore-retry.js';