@camstack/types 1.1.21 → 1.1.22

package/dist/index.js

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_sleep = require("./sleep-DaQgDq90.js");
+const require_sleep = require("./sleep-B8cp-HUn.js");
 const require_err_msg = require("./err-msg-COpsHMw2.js");
 let zod = require("zod");
 //#region src/health/wiring-health.ts
@@ -6959,7 +6959,8 @@ var motionDetectionCapability = {
 	methods: {
 		analyze: require_sleep.method(zod.z.object({
 			deviceId: zod.z.number(),
-			frame: FrameInputSchema
+			frame: FrameInputSchema.optional(),
+			frameHandle: require_sleep.FrameHandleSchema.optional()
 		}), MotionAnalysisResultSchema, { kind: "mutation" }),
 		removeCamera: require_sleep.method(zod.z.object({ deviceId: zod.z.number() }), zod.z.void(), { kind: "mutation" }),
 		reset: require_sleep.method(zod.z.void(), zod.z.void(), { kind: "mutation" })
@@ -7277,11 +7278,20 @@ var pipelineExecutorCapability = {
 		* legacy call shape used by existing benchmark code; once all
 		* callers pass it explicitly we make it required.
 		*
-		* Exactly one of `frame`, `imageBase64`, `referenceImage` must be
-		* provided:
+		* Exactly one of `frame`, `frameHandle`, `imageBase64`,
+		* `referenceImage` must be provided:
 		*  - `frame`: runtime dispatch path (runner → decoded broker frame).
 		*    Carries the raw buffer, dimensions, and format; the executor
 		*    uses it directly without base64 round-tripping.
+		*  - `frameHandle` (CB5): a zero-pixel shm `FrameHandle` for the SAME
+		*    decoded frame. Both runner and executor are hub-local processes
+		*    sharing `/dev/shm`, so the executor maps the named segment and
+		*    reads the pixels back zero-copy — eliminating the ~1.2MB
+		*    re-serialisation over UDS/MsgPack the `frame` path pays per call.
+		*    High-risk: the FrameRing is a latest-wins seqlock with no
+		*    refcount, so a recycled slot yields a null read; the executor
+		*    then degrades to an empty result and the runner ships pixels via
+		*    `frame` as the fallback (queue-depth gated on the runner side).
 		*  - `imageBase64`: one-shot test path (benchmark ImageTab).
 		*  - `referenceImage`: named file from the reference-image store.
 		*/
@@ -7289,6 +7299,12 @@ var pipelineExecutorCapability = {
 			engine: PipelineEngineChoiceSchema.optional(),
 			steps: zod.z.array(PipelineStepInputSchema).min(1),
 			frame: FrameInputSchema.optional(),
+			/**
+			* CB5 shm passthrough — a `FrameHandle` naming the same ring slot
+			* the decoded pixels live in. One more member of the one-of
+			* frame/frameHandle/image/imageBase64/referenceImage group.
+			*/
+			frameHandle: require_sleep.FrameHandleSchema.optional(),
 			imageBase64: zod.z.string().optional(),
 			/**
 			* Binary JPEG bytes — preferred over `imageBase64` on internal
@@ -8452,6 +8468,191 @@ var numericSensorCapability = {
 	runtimeState: NumericSensorStatusSchema
 };
 //#endregion
+//#region src/capabilities/pet-feeder.cap.ts
+/**
+* PetKit pet-feeder cap. Models the control + telemetry surface of a
+* cloud-connected smart feeder (Fresh Element / Mini / D3 / D4 / D4S
+* Gemini / D4H / D4SH) as a single coherent slice — bowl food level,
+* battery, desiccant life, feeding state + the four persisted settings
+* (child-lock / indicator-light / feed-sound / volume).
+*
+* Sources: native PetKit (`nodepetkit` `FeederDevice`). Reusable by any
+* feeder integration that speaks the same food/desiccant/hopper surface.
+*
+* `kind: 'poll'` — PetKit exposes only a cloud REST API (no push
+* channel), so the provider refreshes the slice on a poll interval and
+* eagerly after every command.
+*
+* Dual-hopper feeders (D4S/D4SH) split the bowl into two independent
+* hoppers. `isDualHopper` gates the two-hopper UI; `food1`/`food2` carry
+* the per-hopper levels (both `null` on single-hopper models, where
+* `foodLevel` is the single reading). The manual-feed portion honours the
+* PetKit hardware range 4–200 g in 1 g steps.
+*
+* Device status is exposed both raw and decoded, mirroring PetKit's HA
+* integration (RobertD502/py-petkit-api). `status` is the connectivity /
+* power enum (`normal` / `offline` / `on_batteries`); `error` is the
+* decoded human-readable fault message (null / `no_error` = healthy);
+* `errorCode` keeps the raw device integer (0 / null = no error) so a
+* provider that only has the numeric code stays lossless. A provider maps
+* the library's fields onto these; any it cannot determine stays `null`.
+*/
+/** PetKit manual-feed portion bounds (grams). Mirrors the HA `manual_feed`
+*  number entity (min 4, max 200, step 1, device_class weight). */
+var PET_FEEDER_MANUAL_FEED_MIN = 4;
+var PET_FEEDER_MANUAL_FEED_MAX = 200;
+/**
+* Feeder connectivity / power status — mirrors the HA petkit device-status
+* enum: `normal` (online, mains), `offline` (not reaching PetKit cloud),
+* `on_batteries` (running on battery backup). `null` until first reported.
+*/
+var PetFeederDeviceStatusSchema = zod.z.enum([
+	"normal",
+	"offline",
+	"on_batteries"
+]);
+var gramsPortion = zod.z.number().int().min(4).max(200);
+var PetFeederStatusSchema = zod.z.object({
+	/** Food currently in the bowl (grams). Null when the device has not
+	*  reported a reading yet. On dual-hopper models this is the combined
+	*  bowl reading; per-hopper levels live in `food1`/`food2`. */
+	foodLevel: zod.z.number().nullable(),
+	/** Hopper-1 food level (grams) on dual-hopper feeders; null on
+	*  single-hopper models. */
+	food1: zod.z.number().nullable(),
+	/** Hopper-2 food level (grams) on dual-hopper feeders; null on
+	*  single-hopper models. */
+	food2: zod.z.number().nullable(),
+	/** Derived low-food flag — mirrors the HA `food_level` binary_sensor
+	*  (`device_class: problem`, on = low). True when the bowl is empty /
+	*  below the feeder's low threshold. */
+	lowFood: zod.z.boolean(),
+	/** Battery charge 0..100 (%). Null on mains-powered models or when the
+	*  device has no battery reading. */
+	batteryPower: zod.z.number().min(0).max(100).nullable(),
+	/** Days of desiccant life remaining. Null when the model has no
+	*  desiccant sensor. */
+	desiccantLeftDays: zod.z.number().nullable(),
+	/** True while a feed is in progress. */
+	feeding: zod.z.boolean(),
+	/** Decoded connectivity / power status (HA petkit device-status enum).
+	*  Null until the device has reported a status. */
+	status: PetFeederDeviceStatusSchema.nullable(),
+	/** Decoded human-readable fault message. Null (or the device's `no_error`
+	*  sentinel) means healthy; a non-null string is an active fault. Pairs
+	*  with `errorCode` for consumers that want the raw integer. */
+	error: zod.z.string().nullable(),
+	/** Raw device error code (0 / null = no error). */
+	errorCode: zod.z.number().nullable(),
+	/** True for D4S/D4SH dual-hopper hardware — gates the per-hopper UI. */
+	isDualHopper: zod.z.boolean(),
+	/** Child-lock (manual-lock) setting — buttons on the unit are disabled. */
+	childLock: zod.z.boolean(),
+	/** Front indicator-light setting. */
+	indicatorLight: zod.z.boolean(),
+	/** Play a chime when dispensing. */
+	feedSound: zod.z.boolean(),
+	/** Speaker / prompt volume level (device-scaled integer). */
+	volume: zod.z.number(),
+	/** Ms epoch when the slice was last refreshed from the cloud. */
+	lastFetchedAt: zod.z.number()
+});
+var petFeederCapability = {
+	name: "pet-feeder",
+	scope: "device",
+	deviceNative: true,
+	mode: "singleton",
+	deviceTypes: [require_sleep.DeviceType.PetFeeder],
+	methods: {
+		/**
+		* Dispense food now. Single-hopper feeders take `grams`; dual-hopper
+		* feeders (D4S/D4SH) accept `hopper1`/`hopper2` to target one or both
+		* hoppers. All portions honour the 4–200 g hardware range. At least
+		* one of the three must be present — the provider rejects an empty
+		* request.
+		*/
+		feed: require_sleep.method(zod.z.object({
+			deviceId: zod.z.number().int().nonnegative(),
+			grams: gramsPortion.optional(),
+			hopper1: gramsPortion.optional(),
+			hopper2: gramsPortion.optional()
+		}), zod.z.void(), {
+			kind: "mutation",
+			auth: "admin"
+		}),
+		/** Cancel an in-progress manual feed. */
+		cancelFeed: require_sleep.method(zod.z.object({ deviceId: zod.z.number().int().nonnegative() }), zod.z.void(), {
+			kind: "mutation",
+			auth: "admin"
+		}),
+		/** Reset the desiccant "days remaining" counter after replacing it. */
+		resetDesiccant: require_sleep.method(zod.z.object({ deviceId: zod.z.number().int().nonnegative() }), zod.z.void(), {
+			kind: "mutation",
+			auth: "admin"
+		}),
+		/** Mark a hopper as refilled (D4H/D4S/D4SH). */
+		markFoodReplenished: require_sleep.method(zod.z.object({ deviceId: zod.z.number().int().nonnegative() }), zod.z.void(), {
+			kind: "mutation",
+			auth: "admin"
+		}),
+		/** Call the pet with the recorded prompt (D3). */
+		callPet: require_sleep.method(zod.z.object({ deviceId: zod.z.number().int().nonnegative() }), zod.z.void(), {
+			kind: "mutation",
+			auth: "admin"
+		}),
+		/** Play a stored sound by id (D3 / D4H / D4SH). */
+		playSound: require_sleep.method(zod.z.object({
+			deviceId: zod.z.number().int().nonnegative(),
+			soundId: zod.z.number().int().nonnegative()
+		}), zod.z.void(), {
+			kind: "mutation",
+			auth: "admin"
+		}),
+		/** Toggle the child-lock (manual-lock) setting. */
+		setChildLock: require_sleep.method(zod.z.object({
+			deviceId: zod.z.number().int().nonnegative(),
+			on: zod.z.boolean()
+		}), zod.z.void(), {
+			kind: "mutation",
+			auth: "admin"
+		}),
+		/** Toggle the front indicator light. */
+		setIndicatorLight: require_sleep.method(zod.z.object({
+			deviceId: zod.z.number().int().nonnegative(),
+			on: zod.z.boolean()
+		}), zod.z.void(), {
+			kind: "mutation",
+			auth: "admin"
+		}),
+		/** Toggle the dispense chime. */
+		setFeedSound: require_sleep.method(zod.z.object({
+			deviceId: zod.z.number().int().nonnegative(),
+			on: zod.z.boolean()
+		}), zod.z.void(), {
+			kind: "mutation",
+			auth: "admin"
+		}),
+		/** Set the speaker / prompt volume level. */
+		setVolume: require_sleep.method(zod.z.object({
+			deviceId: zod.z.number().int().nonnegative(),
+			level: zod.z.number().int().nonnegative()
+		}), zod.z.void(), {
+			kind: "mutation",
+			auth: "admin"
+		})
+	},
+	status: {
+		schema: PetFeederStatusSchema,
+		kind: "poll"
+	},
+	/**
+	* Runtime-state slice — mirrored by the kernel. UI feeder cards read
+	* the full slice via `device.state.petFeeder.value` and refresh on
+	* every poll without re-querying the provider.
+	*/
+	runtimeState: PetFeederStatusSchema
+};
+//#endregion
 //#region src/capabilities/power-meter.cap.ts
 /**
 * Multi-metric electrical meter. One slice can carry any combination
@@ -9908,6 +10109,7 @@ var DEVICE_LOCAL_STATE_CAPS = {
 	nativeObjectDetection: nativeObjectDetectionCapability,
 	notifier: notifierCapability,
 	numericSensor: numericSensorCapability,
+	petFeeder: petFeederCapability,
 	powerMeter: powerMeterCapability,
 	presence: presenceCapability,
 	pressureSensor: pressureSensorCapability,
@@ -14077,11 +14279,13 @@ var decoderCapability = {
 		}), zod.z.void()),
 		pullFrames: require_sleep.method(zod.z.object({
 			sessionId: zod.z.string(),
-			maxCount: zod.z.number().default(1)
+			maxCount: zod.z.number().default(1),
+			waitMs: zod.z.number().optional()
 		}), zod.z.array(require_sleep.DecodedFrameSchema)),
 		pullHandles: require_sleep.method(zod.z.object({
 			sessionId: zod.z.string(),
-			maxCount: zod.z.number().default(1)
+			maxCount: zod.z.number().default(1),
+			waitMs: zod.z.number().optional()
 		}), zod.z.array(require_sleep.FrameHandleSchema)),
 		getFrame: require_sleep.method(zod.z.object({ handle: require_sleep.FrameHandleSchema }), require_sleep.DecodedFrameSchema.nullable()),
 		getShmStats: require_sleep.method(zod.z.object({ sessionId: zod.z.string() }), ShmRingStatsSchema.nullable()),
@@ -20609,7 +20813,10 @@ var HwAccelBackendInputSchema = zod.z.enum([
 	"webgpu",
 	"none"
 ]).nullable().optional();
-var HwAccelResolutionSchema = zod.z.object({ preferred: zod.z.array(zod.z.string()).readonly() });
+var HwAccelResolutionSchema = zod.z.object({
+	preferred: zod.z.array(zod.z.string()).readonly(),
+	rationale: zod.z.string()
+});
 var HardwareEncoderIdSchema = zod.z.enum([
 	"h264_videotoolbox",
 	"hevc_videotoolbox",
@@ -20723,10 +20930,7 @@ var platformProbeCapability = {
 		getCapabilities: require_sleep.method(zod.z.void(), PlatformCapabilitiesSchema),
 		getHardware: require_sleep.method(zod.z.void(), HardwareInfoSchema),
 		resolveInferenceConfig: require_sleep.method(zod.z.object({ requirements: zod.z.array(ModelRequirementSchema).readonly() }), ResolvedInferenceConfigSchema),
-		resolveHwAccel: require_sleep.method(zod.z.object({
-			prefer: HwAccelBackendInputSchema,
-			nodeId: zod.z.string().optional()
-		}), HwAccelResolutionSchema),
+		resolveHwAccel: require_sleep.method(zod.z.object({ prefer: HwAccelBackendInputSchema }), HwAccelResolutionSchema),
 		/**
 		* Hardware-encoder probe — see Task #185. Cached after first call.
 		*/
@@ -21828,6 +22032,7 @@ var CAPABILITY_NAMES = {
 	numericSensor: "numeric-sensor",
 	oauthIntegration: "oauth-integration",
 	osd: "osd",
+	petFeeder: "pet-feeder",
 	pipelineAnalytics: "pipeline-analytics",
 	pipelineExecutor: "pipeline-executor",
 	pipelineOrchestrator: "pipeline-orchestrator",
@@ -22228,6 +22433,10 @@ var CAPABILITY_ROUTER_KEYS = [
 		key: "osd",
 		name: "osd"
 	},
+	{
+		key: "petFeeder",
+		name: "pet-feeder"
+	},
 	{
 		key: "pipelineAnalytics",
 		name: "pipeline-analytics"
@@ -22522,6 +22731,7 @@ var ALL_CAPABILITY_DEFINITIONS = [
 	numericSensorCapability,
 	oauthIntegrationCapability,
 	osdCapability,
+	petFeederCapability,
 	pipelineAnalyticsCapability,
 	pipelineExecutorCapability,
 	pipelineOrchestratorCapability,
@@ -22624,6 +22834,7 @@ var CAP_NAMES_WITH_STATUS = [
 	"notifier",
 	"numeric-sensor",
 	"osd",
+	"pet-feeder",
 	"power-meter",
 	"presence",
 	"pressure-sensor",
@@ -25090,6 +25301,66 @@ var METHOD_ACCESS_MAP = Object.freeze({
 		addonId: null,
 		access: "create"
 	},
+	"petFeeder.callPet": {
+		capName: "pet-feeder",
+		capScope: "device",
+		addonId: null,
+		access: "create"
+	},
+	"petFeeder.cancelFeed": {
+		capName: "pet-feeder",
+		capScope: "device",
+		addonId: null,
+		access: "create"
+	},
+	"petFeeder.feed": {
+		capName: "pet-feeder",
+		capScope: "device",
+		addonId: null,
+		access: "create"
+	},
+	"petFeeder.markFoodReplenished": {
+		capName: "pet-feeder",
+		capScope: "device",
+		addonId: null,
+		access: "create"
+	},
+	"petFeeder.playSound": {
+		capName: "pet-feeder",
+		capScope: "device",
+		addonId: null,
+		access: "create"
+	},
+	"petFeeder.resetDesiccant": {
+		capName: "pet-feeder",
+		capScope: "device",
+		addonId: null,
+		access: "delete"
+	},
+	"petFeeder.setChildLock": {
+		capName: "pet-feeder",
+		capScope: "device",
+		addonId: null,
+		access: "create"
+	},
+	"petFeeder.setFeedSound": {
+		capName: "pet-feeder",
+		capScope: "device",
+		addonId: null,
+		access: "create"
+	},
+	"petFeeder.setIndicatorLight": {
+		capName: "pet-feeder",
+		capScope: "device",
+		addonId: null,
+		access: "create"
+	},
+	"petFeeder.setVolume": {
+		capName: "pet-feeder",
+		capScope: "device",
+		addonId: null,
+		access: "create"
+	},
 	"pipelineAnalytics.clearTracks": {
 		capName: "pipeline-analytics",
 		capScope: "device",
@@ -27082,6 +27353,7 @@ var KNOWN_CAP_NAMES = [
 	"notifier",
 	"oauth-integration",
 	"osd",
+	"pet-feeder",
 	"pipeline-analytics",
 	"pipeline-executor",
 	"pipeline-orchestrator",
@@ -27157,6 +27429,7 @@ var DEVICE_CAP_NAMES = [
 	"native-object-detection",
 	"notifier",
 	"osd",
+	"pet-feeder",
 	"pipeline-analytics",
 	"privacy-mask",
 	"ptz",
@@ -28123,6 +28396,8 @@ exports.OsdOverlayPatchSchema = OsdOverlayPatchSchema;
 exports.OsdOverlaySchema = OsdOverlaySchema;
 exports.OsdPositionEnum = OsdPositionEnum;
 exports.OsdStatusSchema = OsdStatusSchema;
+exports.PET_FEEDER_MANUAL_FEED_MAX = PET_FEEDER_MANUAL_FEED_MAX;
+exports.PET_FEEDER_MANUAL_FEED_MIN = PET_FEEDER_MANUAL_FEED_MIN;
 exports.PIPELINE_FLOW_CAPABILITY_NAMES = PIPELINE_FLOW_CAPABILITY_NAMES;
 exports.PIPELINE_OWNER_CAPABILITY_NAMES = PIPELINE_OWNER_CAPABILITY_NAMES;
 exports.PROVIDER_KIND_CAP_NAMES = PROVIDER_KIND_CAP_NAMES;
@@ -28132,6 +28407,7 @@ exports.PackageVersionInfoSchema = PackageVersionInfoSchema;
 exports.PasskeySummarySchema = PasskeySummarySchema;
 exports.PcmSampleFormatSchema = PcmSampleFormatSchema;
 exports.PerScopeBreakdownSchema = PerScopeBreakdownSchema;
+exports.PetFeederStatusSchema = PetFeederStatusSchema;
 exports.PickStreamPreferencesSchema = PickStreamPreferencesSchema;
 exports.PickStreamRequirementsSchema = PickStreamRequirementsSchema;
 exports.PickedCamStreamSchema = PickedCamStreamSchema;
@@ -28487,6 +28763,7 @@ exports.parseJsonUnknown = require_sleep.parseJsonUnknown;
 exports.parseProfileBrokerId = require_sleep.parseProfileBrokerId;
 exports.parseStreamParamsFormPatch = parseStreamParamsFormPatch;
 exports.pendingFrameworkSwapSchema = pendingFrameworkSwapSchema;
+exports.petFeederCapability = petFeederCapability;
 exports.pickPreferredRtspEntry = pickPreferredRtspEntry;
 exports.pipelineAnalyticsCapability = pipelineAnalyticsCapability;
 exports.pipelineExecutorCapability = pipelineExecutorCapability;