@camstack/types 1.1.18 → 1.1.20

package/dist/generated/addon-api.d.ts

@@ -4100,6 +4100,15 @@ export type AppRouter = import("@trpc/server/unstable-core-do-not-import").Route
                         sourceKey: string;
                         cap: string;
                         fieldPath: string;
+                        kind?: "field" | undefined;
+                    } | {
+                        kind: "literal";
+                        value: string | number | boolean | null;
+                    } | {
+                        kind: "global";
+                        sourceStableId: string;
+                        cap: string;
+                        fieldPath: string;
                     };
                     target: {
                         cap: string;
@@ -4201,6 +4210,15 @@ export type AppRouter = import("@trpc/server/unstable-core-do-not-import").Route
                         sourceKey: string;
                         cap: string;
                         fieldPath: string;
+                        kind?: "field" | undefined;
+                    } | {
+                        kind: "literal";
+                        value: string | number | boolean | null;
+                    } | {
+                        kind: "global";
+                        sourceStableId: string;
+                        cap: string;
+                        fieldPath: string;
                     };
                     target: {
                         cap: string;
@@ -4228,6 +4246,7 @@ export type AppRouter = import("@trpc/server/unstable-core-do-not-import").Route
             input: {
                 [x: string]: unknown;
                 deviceId: number;
+                includeSynthesizable?: boolean | undefined;
             };
             output: {
                 caps: readonly {
@@ -4236,7 +4255,12 @@ export type AppRouter = import("@trpc/server/unstable-core-do-not-import").Route
                         path: string;
                         kind: "string" | "number" | "boolean" | "enum";
                         enumValues?: string[] | undefined;
+                        item?: boolean | undefined;
                     }[];
+                    itemArray?: {
+                        path: string;
+                        keyField: string;
+                    } | undefined;
                 }[];
             };
             meta: object;
@@ -4365,6 +4389,15 @@ export type AppRouter = import("@trpc/server/unstable-core-do-not-import").Route
                         sourceKey: string;
                         cap: string;
                         fieldPath: string;
+                        kind?: "field" | undefined;
+                    } | {
+                        kind: "literal";
+                        value: string | number | boolean | null;
+                    } | {
+                        kind: "global";
+                        sourceStableId: string;
+                        cap: string;
+                        fieldPath: string;
                     };
                     target: {
                         cap: string;
@@ -4429,6 +4462,15 @@ export type AppRouter = import("@trpc/server/unstable-core-do-not-import").Route
                         sourceKey: string;
                         cap: string;
                         fieldPath: string;
+                        kind?: "field" | undefined;
+                    } | {
+                        kind: "literal";
+                        value: string | number | boolean | null;
+                    } | {
+                        kind: "global";
+                        sourceStableId: string;
+                        cap: string;
+                        fieldPath: string;
                     };
                     target: {
                         cap: string;
@@ -4493,6 +4535,15 @@ export type AppRouter = import("@trpc/server/unstable-core-do-not-import").Route
                         sourceKey: string;
                         cap: string;
                         fieldPath: string;
+                        kind?: "field" | undefined;
+                    } | {
+                        kind: "literal";
+                        value: string | number | boolean | null;
+                    } | {
+                        kind: "global";
+                        sourceStableId: string;
+                        cap: string;
+                        fieldPath: string;
                     };
                     target: {
                         cap: string;
@@ -4650,7 +4701,7 @@ export type AppRouter = import("@trpc/server/unstable-core-do-not-import").Route
                 deviceId: number;
                 entries: {
                     capName: string;
-                    kind: "native" | "wrapped";
+                    kind: "linked" | "native" | "wrapped";
                     providerAddonId: string;
                     providerNodeId: string;
                     nativeAddonId: string;
@@ -4666,7 +4717,7 @@ export type AppRouter = import("@trpc/server/unstable-core-do-not-import").Route
                 deviceId: number;
                 entries: {
                     capName: string;
-                    kind: "native" | "wrapped";
+                    kind: "linked" | "native" | "wrapped";
                     providerAddonId: string;
                     providerNodeId: string;
                     nativeAddonId: string;
@@ -10011,6 +10062,13 @@ export type AppRouter = import("@trpc/server/unstable-core-do-not-import").Route
                 onboardMotionDrivesAnalyzer?: boolean | undefined;
                 occupancyRecheckSec?: number | undefined;
                 occupancyRecheckFrames?: number | undefined;
+                frameSource?: {
+                    kind: "local-broker";
+                } | {
+                    kind: "remote-restream";
+                    ownerNodeId: string;
+                    hubHostnameOverride?: string | undefined;
+                } | undefined;
             };
             output: {
                 success: true;
@@ -18117,6 +18175,15 @@ export type AppRouter = import("@trpc/server/unstable-core-do-not-import").Route
                         sourceKey: string;
                         cap: string;
                         fieldPath: string;
+                        kind?: "field" | undefined;
+                    } | {
+                        kind: "literal";
+                        value: string | number | boolean | null;
+                    } | {
+                        kind: "global";
+                        sourceStableId: string;
+                        cap: string;
+                        fieldPath: string;
                     };
                     target: {
                         cap: string;
@@ -18218,6 +18285,15 @@ export type AppRouter = import("@trpc/server/unstable-core-do-not-import").Route
                         sourceKey: string;
                         cap: string;
                         fieldPath: string;
+                        kind?: "field" | undefined;
+                    } | {
+                        kind: "literal";
+                        value: string | number | boolean | null;
+                    } | {
+                        kind: "global";
+                        sourceStableId: string;
+                        cap: string;
+                        fieldPath: string;
                     };
                     target: {
                         cap: string;
@@ -18245,6 +18321,7 @@ export type AppRouter = import("@trpc/server/unstable-core-do-not-import").Route
             input: {
                 [x: string]: unknown;
                 deviceId: number;
+                includeSynthesizable?: boolean | undefined;
             };
             output: {
                 caps: readonly {
@@ -18253,7 +18330,12 @@ export type AppRouter = import("@trpc/server/unstable-core-do-not-import").Route
                         path: string;
                         kind: "string" | "number" | "boolean" | "enum";
                         enumValues?: string[] | undefined;
+                        item?: boolean | undefined;
                     }[];
+                    itemArray?: {
+                        path: string;
+                        keyField: string;
+                    } | undefined;
                 }[];
             };
             meta: object;
@@ -18382,6 +18464,15 @@ export type AppRouter = import("@trpc/server/unstable-core-do-not-import").Route
                         sourceKey: string;
                         cap: string;
                         fieldPath: string;
+                        kind?: "field" | undefined;
+                    } | {
+                        kind: "literal";
+                        value: string | number | boolean | null;
+                    } | {
+                        kind: "global";
+                        sourceStableId: string;
+                        cap: string;
+                        fieldPath: string;
                     };
                     target: {
                         cap: string;
@@ -18446,6 +18537,15 @@ export type AppRouter = import("@trpc/server/unstable-core-do-not-import").Route
                         sourceKey: string;
                         cap: string;
                         fieldPath: string;
+                        kind?: "field" | undefined;
+                    } | {
+                        kind: "literal";
+                        value: string | number | boolean | null;
+                    } | {
+                        kind: "global";
+                        sourceStableId: string;
+                        cap: string;
+                        fieldPath: string;
                     };
                     target: {
                         cap: string;
@@ -18510,6 +18610,15 @@ export type AppRouter = import("@trpc/server/unstable-core-do-not-import").Route
                         sourceKey: string;
                         cap: string;
                         fieldPath: string;
+                        kind?: "field" | undefined;
+                    } | {
+                        kind: "literal";
+                        value: string | number | boolean | null;
+                    } | {
+                        kind: "global";
+                        sourceStableId: string;
+                        cap: string;
+                        fieldPath: string;
                     };
                     target: {
                         cap: string;
@@ -18667,7 +18776,7 @@ export type AppRouter = import("@trpc/server/unstable-core-do-not-import").Route
                 deviceId: number;
                 entries: {
                     capName: string;
-                    kind: "native" | "wrapped";
+                    kind: "linked" | "native" | "wrapped";
                     providerAddonId: string;
                     providerNodeId: string;
                     nativeAddonId: string;
@@ -18683,7 +18792,7 @@ export type AppRouter = import("@trpc/server/unstable-core-do-not-import").Route
                 deviceId: number;
                 entries: {
                     capName: string;
-                    kind: "native" | "wrapped";
+                    kind: "linked" | "native" | "wrapped";
                     providerAddonId: string;
                     providerNodeId: string;
                     nativeAddonId: string;
@@ -24028,6 +24137,13 @@ export type AppRouter = import("@trpc/server/unstable-core-do-not-import").Route
                 onboardMotionDrivesAnalyzer?: boolean | undefined;
                 occupancyRecheckSec?: number | undefined;
                 occupancyRecheckFrames?: number | undefined;
+                frameSource?: {
+                    kind: "local-broker";
+                } | {
+                    kind: "remote-restream";
+                    ownerNodeId: string;
+                    hubHostnameOverride?: string | undefined;
+                } | undefined;
             };
             output: {
                 success: true;

package/dist/index.d.ts

@@ -147,12 +147,12 @@ export type { ICameraDevice, StreamSourceEntry } from './device/camera-device.js
 export type { StreamQuality } from './interfaces/device-capabilities/camera.js';
 export { STREAM_QUALITY_LABELS, streamQualityLabel, } from './interfaces/device-capabilities/camera.js';
 export type { AudioCodecInfo, AudioDecodeSessionConfig, AudioEncodeSessionConfig, AudioPcmChunk, AudioEncodedChunk, PcmSampleFormat, } from './interfaces/audio-codec.js';
-export type { DeviceManualCreation, DeviceDiscovery, DiscoveredDevice, SavedDevice, DeviceMeta, InitialDeviceMeta, CreateDeviceSpec, ChildLayout, ChildLayoutEntry, DeviceLinkSource, DeviceLinkTarget, DeviceLinkTransform, DeviceLink, DeviceLinks, } from './device/device-management.js';
+export type { DeviceManualCreation, DeviceDiscovery, DiscoveredDevice, SavedDevice, DeviceMeta, InitialDeviceMeta, CreateDeviceSpec, ChildLayout, ChildLayoutEntry, DeviceLinkFieldSource, DeviceLinkLiteralSource, DeviceLinkSource, DeviceLinkTarget, DeviceLinkTransform, DeviceLink, DeviceLinks, } from './device/device-management.js';
 export { zodEntriesToConfigUI } from './device/zod-to-config-ui.js';
 export type { DeviceConfigEntry } from './device/zod-to-config-ui.js';
 export { getByPath, setByPath } from './device/path-util.js';
 export { applyTransform } from './device/device-link-transform.js';
-export { enumerateSchemaFields } from './device/schema-fields.js';
+export { enumerateItemArrayFields, enumerateSchemaFields } from './device/schema-fields.js';
 export type { WireableField } from './device/schema-fields.js';
 export { EventCategory } from './enums/event-category.js';
 export type { AppRouter, AddonApi } from './generated/addon-api.js';

package/dist/index.js

@@ -534,6 +534,25 @@ function findTimezone(id) {
 //#endregion
 //#region src/interfaces/recording-config.ts
 /**
+* THE canonical event-clip pad: the time window a single-timestamp analytics
+* event expands to when joined with footage (clip window = `[timestamp - preMs,
+* timestamp + postMs]`). Matches the admin-ui clip window (−5s/+10s).
+*
+* Every consumer derives from this ONE constant so event↔footage boundaries
+* agree everywhere (C1):
+*   - the `videoclips` default provider (addon-post-analysis) pads its clip
+*     windows with it;
+*   - the recorder's ephemeral in-RAM `EventMap` markers (addon-pipeline) pad
+*     their `startMs/endMs` with it.
+*
+* NOTE: this is a UI/JOIN convention, NOT the `events`-band keep/discard gate —
+* that uses the per-device `preBufferSec`/`postBufferSec` config.
+*/
+var EVENT_PAD_MS = {
+	preMs: 5e3,
+	postMs: 1e4
+};
+/**
 * Numeric day-of-week: 0 = Sunday … 6 = Saturday (matches `Date.getDay`).
 * Named `RecordingWeekday` to avoid collision with the string-union
 * `Weekday` exported from `interfaces/timezones.ts`.
@@ -3555,7 +3574,13 @@ onStatusChanged: { data: zod.z.object({
 	}) } },
 	status: {
 		schema: BatteryStatusSchema,
-		kind: "push"
+		kind: "push",
+		empty: {
+			percentage: 0,
+			charging: "none",
+			sleeping: false,
+			lastUpdated: 0
+		}
 	},
 	/**
 	* Runtime-state slice — every provider that registers this cap
@@ -4735,7 +4760,25 @@ reset: require_sleep.method(zod.z.object({
 	}) },
 	status: {
 		schema: ConsumablesStatusSchema,
-		kind: "push"
+		kind: "push",
+		empty: {
+			items: [],
+			lastChangedAt: 0
+		},
+		itemArray: {
+			path: "items",
+			keyField: "key",
+			labelField: "label",
+			itemSchema: ConsumableItemSchema,
+			emptyItem: {
+				key: "",
+				label: "",
+				level: null,
+				status: null,
+				lastResetAt: null,
+				resettable: false
+			}
+		}
 	},
 	runtimeState: ConsumablesStatusSchema.extend({ lastFetchedAt: zod.z.number() })
 };
@@ -6765,6 +6808,31 @@ var ReportMotionInputSchema = zod.z.object({
 	regions: zod.z.array(MotionRegionSchema).readonly().optional()
 });
 /**
+* Where a runner gets a camera's decoded frames (cross-node Phase 2,
+* restream-owner model — P2c).
+*
+* - `local-broker` (DEFAULT): today's path — subscribe to the co-located
+*   stream-broker's shm frame plane. Every pre-P2c attach payload (no
+*   `frameSource` key) parses to this, so the field is additive with zero
+*   behavior change.
+* - `remote-restream`: the detect node is NOT the camera's source-owner.
+*   The runner acquires the owner's COMPRESSED passthrough restream
+*   (`streamBroker.getStreamWithCodec({video:'copy'})` — refcounted, the
+*   double-pull guard) and decodes LOCALLY via a satellite frame plane +
+*   pull-mode decoder session pinned to its own node. The shm ring stays
+*   node-local; only H.264/H.265 packets cross the wire.
+*   `hubHostnameOverride` mirrors the recorder's `recordingHubHostname`:
+*   when set it overrides the `CAMSTACK_HUB_URL`-derived host the runner
+*   dials for the owner's restream.
+*/
+var RunnerFrameSourceSchema = zod.z.discriminatedUnion("kind", [zod.z.object({ kind: zod.z.literal("local-broker") }), zod.z.object({
+	kind: zod.z.literal("remote-restream"),
+	/** The camera's source-owner node (slice 1: always the hub). */
+	ownerNodeId: zod.z.string(),
+	/** Operator override for the owner host the runner dials. */
+	hubHostnameOverride: zod.z.string().optional()
+})]).describe("Per-camera frame-source mode for the runner (P2c)");
+/**
 * Camera assignment payload sent by `addon-pipeline-orchestrator` to a
 * specific runner instance via `attachCamera`. Carries everything the
 * runner needs to subscribe to the local broker and execute inference.
@@ -6862,7 +6930,15 @@ var RunnerCameraConfigSchema = zod.z.object({
 	*/
 	onboardMotionDrivesAnalyzer: zod.z.boolean().default(true),
 	occupancyRecheckSec: zod.z.number().min(occupancyRecheckSecField.min).max(occupancyRecheckSecField.max).default(occupancyRecheckSecField.default),
-	occupancyRecheckFrames: zod.z.number().min(occupancyRecheckFramesField.min).max(occupancyRecheckFramesField.max).default(occupancyRecheckFramesField.default)
+	occupancyRecheckFrames: zod.z.number().min(occupancyRecheckFramesField.min).max(occupancyRecheckFramesField.max).default(occupancyRecheckFramesField.default),
+	/**
+	* Where this runner gets the camera's decoded frames (P2c). Defaulted so
+	* every existing payload behaves as `local-broker` — the pre-Phase-2 path.
+	* Populated with `remote-restream` by the orchestrator ONLY when the
+	* camera's detect node differs from its source-owner (P2d, gated by the
+	* `remoteSourcingNodes` rollout setting).
+	*/
+	frameSource: RunnerFrameSourceSchema.default({ kind: "local-broker" })
 });
 /**
 * Per-device settings UI fields the runner cap owns. Co-located with
@@ -10169,6 +10245,17 @@ function enumerateSchemaFields(schema, prefix = "") {
 	}
 	return out;
 }
+/** Enumerate the per-item wireable fields of an item-array cap (see
+*  `CapabilityStatusItemArray`): the item schema's leaf fields, minus the
+*  `keyField` (the key comes from the link's `itemKey`, never from a wired
+*  source), each tagged `item: true` so the authoring UI collects an
+*  `itemKey` alongside the field. Never throws. */
+function enumerateItemArrayFields(itemArray) {
+	return enumerateSchemaFields(itemArray.itemSchema).filter((f) => f.path !== itemArray.keyField).map((f) => ({
+		...f,
+		item: true
+	}));
+}
 //#endregion
 //#region src/utils/zone-rule-eval.ts
 /**
@@ -13271,14 +13358,36 @@ var ChildLayoutEntrySchema = zod.z.object({
 	collapsed: zod.z.boolean().optional()
 });
 /** Cap-wire shape of a DeviceLink — structurally mirrors `DeviceLink` in
-*  `device-management.ts`. */
+*  `device-management.ts`. Source is a union: a FIELD source copies a sibling
+*  accessory's status field (`kind` optional/absent for wire compat); a
+*  LITERAL source carries a per-device constant (no sibling is read); a
+*  GLOBAL source (P2e) copies ANY device's status field, addressed by the
+*  source device's full re-sync-stable `stableId`. */
 var DeviceLinkSchema = zod.z.object({
 	id: zod.z.string(),
-	source: zod.z.object({
-		sourceKey: zod.z.string(),
-		cap: zod.z.string(),
-		fieldPath: zod.z.string()
-	}),
+	source: zod.z.union([
+		zod.z.object({
+			kind: zod.z.literal("field").optional(),
+			sourceKey: zod.z.string(),
+			cap: zod.z.string(),
+			fieldPath: zod.z.string()
+		}),
+		zod.z.object({
+			kind: zod.z.literal("literal"),
+			value: zod.z.union([
+				zod.z.string(),
+				zod.z.number(),
+				zod.z.boolean(),
+				zod.z.null()
+			])
+		}),
+		zod.z.object({
+			kind: zod.z.literal("global"),
+			sourceStableId: zod.z.string(),
+			cap: zod.z.string(),
+			fieldPath: zod.z.string()
+		})
+	]),
 	target: zod.z.object({
 		cap: zod.z.string(),
 		fieldPath: zod.z.string(),
@@ -13584,8 +13693,18 @@ var deviceManagerCapability = {
 			auth: "admin"
 		}),
 		/** List the wireable status-schema fields per cap bound to a device.
-		*  Powers the Wiring tab's field pickers. Caps without a status schema are omitted. */
-		getWireableFields: require_sleep.method(zod.z.object({ deviceId: zod.z.number() }), zod.z.object({ caps: zod.z.array(zod.z.object({
+		*  Powers the Wiring tab's field pickers. Caps without a status schema are
+		*  omitted. Item-array caps (`status.itemArray`, e.g. consumables) also
+		*  emit their per-item fields tagged `item: true` (a link targeting one
+		*  must carry a `target.itemKey`) plus the cap-level `itemArray`
+		*  descriptor. `includeSynthesizable: true` (TARGET pickers only) unions
+		*  in unbound device-scoped caps that declare `status.empty` and match
+		*  the device's type — so the FIRST link to a synthesize-only cap
+		*  (consumables on an HA vacuum) can be authored. */
+		getWireableFields: require_sleep.method(zod.z.object({
+			deviceId: zod.z.number(),
+			includeSynthesizable: zod.z.boolean().optional()
+		}), zod.z.object({ caps: zod.z.array(zod.z.object({
 			cap: zod.z.string(),
 			fields: zod.z.array(zod.z.object({
 				path: zod.z.string(),
@@ -13595,8 +13714,13 @@ var deviceManagerCapability = {
 					"boolean",
 					"enum"
 				]),
-				enumValues: zod.z.array(zod.z.string()).optional()
-			})).readonly()
+				enumValues: zod.z.array(zod.z.string()).optional(),
+				item: zod.z.boolean().optional()
+			})).readonly(),
+			itemArray: zod.z.object({
+				path: zod.z.string(),
+				keyField: zod.z.string()
+			}).optional()
 		})).readonly() }), { kind: "query" }),
 		/** Stamp (or update) the semantic role on the device's meta row.
 		*  Called by the kernel's `create()` / `spawnAccessoryChild` pre-seed
@@ -13747,7 +13871,11 @@ var deviceManagerCapability = {
 			deviceId: zod.z.number(),
 			entries: zod.z.array(zod.z.object({
 				capName: zod.z.string(),
-				kind: zod.z.enum(["native", "wrapped"]),
+				kind: zod.z.enum([
+					"native",
+					"wrapped",
+					"linked"
+				]),
 				providerAddonId: zod.z.string(),
 				providerNodeId: zod.z.string(),
 				nativeAddonId: zod.z.string()
@@ -13765,7 +13893,11 @@ var deviceManagerCapability = {
 			deviceId: zod.z.number(),
 			entries: zod.z.array(zod.z.object({
 				capName: zod.z.string(),
-				kind: zod.z.enum(["native", "wrapped"]),
+				kind: zod.z.enum([
+					"native",
+					"wrapped",
+					"linked"
+				]),
 				providerAddonId: zod.z.string(),
 				providerNodeId: zod.z.string(),
 				nativeAddonId: zod.z.string()
@@ -19545,6 +19677,16 @@ var rebootCapability = {
 };
 //#endregion
 //#region src/capabilities/recording.cap.ts
+/**
+* `recording` cap — footage availability + HLS playback manifests + per-device
+* recording config. NOTE on events (source of truth, R5/C3): this cap carries
+* NO event surface — `getPlaybackManifest` returns playlist URLs only. Timeline
+* events (motion/object/audio) come from `pipelineAnalytics` (durable SQLite
+* rows); the recorder's internal EventMap markers are ephemeral in-RAM
+* annotations that are not exposed here and must not be treated as an event
+* feed. Event<->footage joins are by time, padded with the shared `EVENT_PAD_MS`
+* (`interfaces/recording-config.ts`).
+*/
 var RecordingStatusSchema = zod.z.object({
 	deviceId: zod.z.number(),
 	enabled: zod.z.boolean(),
@@ -26638,6 +26780,7 @@ exports.DiscoveredTargetSchema = DiscoveredTargetSchema;
 exports.DisposerChain = require_sleep.DisposerChain;
 exports.DoorbellPressEventSchema = DoorbellPressEventSchema;
 exports.DoorbellStatusSchema = DoorbellStatusSchema;
+exports.EVENT_PAD_MS = EVENT_PAD_MS;
 exports.ElementConfigStore = ElementConfigStore;
 exports.EmbeddingInfoSchema = EmbeddingInfoSchema;
 exports.EmbeddingResultSchema = EmbeddingResultSchema;
@@ -26830,6 +26973,7 @@ exports.RtpSourceSchema = RtpSourceSchema;
 exports.RtspRestreamEntrySchema = RtspRestreamEntrySchema;
 exports.RunnerCameraConfigSchema = RunnerCameraConfigSchema;
 exports.RunnerCameraDeviceUIFields = RunnerCameraDeviceUIFields;
+exports.RunnerFrameSourceSchema = RunnerFrameSourceSchema;
 exports.RunnerLocalLoadSchema = RunnerLocalLoadSchema;
 exports.RunnerLocalMetricsSchema = RunnerLocalMetricsSchema;
 exports.SCOPE_PRESETS = SCOPE_PRESETS;
@@ -27024,6 +27168,7 @@ exports.emitDownForOwnedCaps = require_sleep.emitDownForOwnedCaps;
 exports.emitReadiness = require_sleep.emitReadiness;
 exports.encodeProfileFromStreamShape = encodeProfileFromStreamShape;
 exports.enumSensorCapability = enumSensorCapability;
+exports.enumerateItemArrayFields = enumerateItemArrayFields;
 exports.enumerateSchemaFields = enumerateSchemaFields;
 exports.errMsg = require_err_msg.errMsg;
 exports.evaluateZoneRules = evaluateZoneRules;