@camstack/types 1.1.21 → 1.1.22

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

@@ -1,7 +1,7 @@
+import type { ZodType } from 'zod';
 import type { AddonContext, AddonInitResult, CapabilitiesAccess, ProviderRegistration } from '../interfaces/addon.js';
-import type { ConfigUISchema, ConfigUISchemaWithValues, ConfigField, ConfigSection } from '../interfaces/config-ui.js';
+import type { ConfigField, ConfigSection, ConfigUISchema, ConfigUISchemaWithValues } from '../interfaces/config-ui.js';
 import { type DurableState } from './durable-state.js';
-import type { ZodType } from 'zod';
 export type { CapabilitiesAccess };
 /**
  * Utility type that constrains a ConfigField's `key` to only accept
@@ -182,8 +182,29 @@ export declare abstract class BaseAddon<TConfig extends object = Record<string,
     protected globalSettingsSchema(_cap?: string): ConfigUISchema | null;
     /** Override to provide device-level settings UI schema. */
     protected deviceSettingsSchema(): ConfigUISchema | null;
-    getGlobalSettings(overlay?: Record<string, unknown>, cap?: string, _nodeId?: string): Promise<ConfigUISchemaWithValues | null>;
-    updateGlobalSettings(patch: Partial<TConfig>, _nodeId?: string): Promise<void>;
+    getGlobalSettings(overlay?: Record<string, unknown>, cap?: string, nodeId?: string): Promise<ConfigUISchemaWithValues | null>;
+    /**
+     * The raw addon store PROJECTED onto the target node's bare per-node keys:
+     * every `perNode: true` field carries THAT node's scoped value on its bare
+     * key (absent scoped key ⇒ key absent, so the schema `default` wins — no
+     * bare fallback), all `@`-scoped and stray bare per-node keys are dropped.
+     * A no-op passthrough when the schema declares no `perNode` field.
+     *
+     * This is the sanctioned way for a `getGlobalSettings` OVERRIDE that needs
+     * the store for custom option logic (option narrowing, value snapping) to
+     * read it per-node — never `ctx.settings.readAddonStore()` directly.
+     * `nodeId` omitted ⇒ the local node (node-blind injection from ctx).
+     */
+    protected resolveGlobalStore(nodeId?: string, cap?: string): Promise<Record<string, unknown>>;
+    updateGlobalSettings(patch: Partial<TConfig>, nodeId?: string): Promise<void>;
+    /**
+     * The set of field keys the global settings schema declares `perNode: true`
+     * — derived once per `cap` argument and memoized (schemas are static
+     * declarations). Empty set ⇒ every per-node code path is bypassed and the
+     * settings API behaves exactly like the legacy node-agnostic one.
+     */
+    private readonly _perNodeKeysCache;
+    private perNodeKeys;
     /**
      * If any field in `patch` is marked `requiresRestart` in `schema`,
      * schedule an addon restart for the next tick. Deferred via
@@ -255,6 +276,11 @@ export declare abstract class BaseAddon<TConfig extends object = Record<string,
      * The merge is shallow: each key in `defaults` is checked against the store.
      * Only keys present in defaults are read — the store can contain extra keys
      * (e.g. from older versions) without polluting the typed config.
+     *
+     * Keys the global settings schema declares `perNode: true` resolve from
+     * THIS node's scoped key (`<key>@<localNode>`) via `readNodeValue` — never
+     * from the bare key — so a per-node field resolves to this node's own
+     * selection at boot (absent scoped key ⇒ the constructor default wins).
      */
     protected resolveConfig(): Promise<void>;
     /**

package/dist/addon/per-node-store.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Per-node scoping for the shared addon-settings blob.
+ *
+ * An addon's settings store is hub-central (the `addon-settings` cap is
+ * hub-routed — the hub instance answers for every node), so fields whose
+ * value is a NODE fact (decoder backend, engine pick, probed hardware
+ * capabilities) persist under the node-scoped key `<key>@<nodeId>` inside
+ * the single shared blob. The SCHEMA field key stays bare: the write path
+ * ({@link scopePatch}) maps the bare field onto the target node's scoped
+ * key; the read/hydrate path ({@link projectStore}) maps THIS node's value
+ * back, so UI forms and `resolveConfig` only ever see the bare key.
+ *
+ * Fields opt in via the `perNode: true` schema marker on `ConfigFieldBase`
+ * (`interfaces/config-ui.ts`); `BaseAddon` derives the key set from the
+ * schema and routes reads/writes through these helpers.
+ *
+ * ## No bare-key fallback — deliberate
+ *
+ * {@link readNodeValue} reads the node-scoped key ONLY. A node with no
+ * scoped key resolves to `undefined` so the field's schema `default` wins —
+ * NEVER `store[base]` and never another node's value. A bare legacy key in
+ * the store is invisible to every node, hub included, so one node's
+ * selection can never leak onto another. (This generalizes the
+ * `decoder-backend-keys.ts` semantics — the no-fallback variant — over an
+ * arbitrary set of per-node field keys.)
+ *
+ * Pure functions only — no I/O, no imports beyond the language. This is a
+ * LEAF module: import it via its deep path, never from the root barrel.
+ */
+/**
+ * Normalize a raw kernel node id to the bare node id used for scoping.
+ * `localNodeId` can carry a `<node>/<addon>` suffix on forked child
+ * processes; per-node settings are per-NODE, so strip the addon segment.
+ * `undefined` / `null` / empty falls back to `'hub'`.
+ */
+export declare function normalizeNodeId(raw: string | undefined | null): string;
+/** The node-scoped store key for a per-node field: `<base>@<nodeId>`. */
+export declare function nodeScopedKey(base: string, nodeId: string): string;
+/**
+ * Read a node's value for a per-node field from the raw shared store:
+ * the node-scoped key when present, otherwise `undefined`.
+ * Deliberately NO bare-key fallback (see module doc) — the caller lets the
+ * schema `default` win on `undefined`.
+ */
+export declare function readNodeValue(store: Readonly<Record<string, unknown>>, base: string, nodeId: string): unknown;
+/**
+ * Re-map a UI/settings patch so every bare perNode field persists under the
+ * TARGET node's scoped key; all other keys pass through unchanged. Used on
+ * the write path so a save for one node never clobbers another node's value
+ * (and the bare key is never written). Returns a new object — the input
+ * patch is not mutated.
+ */
+export declare function scopePatch(patch: Readonly<Record<string, unknown>>, perNodeKeys: ReadonlySet<string>, nodeId: string): Record<string, unknown>;
+/**
+ * Project the raw shared store onto the bare schema keys for ONE node so a
+ * UI schema (whose field keys are bare) hydrates from that node's own
+ * values:
+ *
+ * - EVERY `@`-scoped key (any node's) is dropped from the pass-through.
+ * - Every bare perNode key is dropped from the pass-through (a stray bare
+ *   legacy key must never hydrate any node — no bare fallback).
+ * - THIS node's effective value ({@link readNodeValue}) is then laid onto
+ *   each bare perNode key; when the node has no scoped key the bare key is
+ *   left ABSENT so the field's schema `default` wins.
+ *
+ * Returns a new object — the input store is not mutated.
+ */
+export declare function projectStore(store: Readonly<Record<string, unknown>>, perNodeKeys: ReadonlySet<string>, nodeId: string): Record<string, unknown>;

package/dist/addon.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");
 exports.BaseAddon = require_sleep.BaseAddon;
 exports.DATAPLANE_SECRET_HEADER = require_sleep.DATAPLANE_SECRET_HEADER;

package/dist/addon.mjs

@@ -1,3 +1,3 @@
-import { A as ReadinessRegistry, C as asJsonObject, O as parseJsonUnknown, P as scopeKey, T as asString, a as adminUiCapability, b as DeviceType, gt as DisposerChain, ht as EventCategory, i as deviceOpsCapability, j as ReadinessTimeoutError, k as DATAPLANE_SECRET_HEADER, o as createDeviceProxy, ot as BaseAddon, p as expandCapMethods, st as normalizeAddonInitResult, t as sleep, ut as emitReadiness } from "./sleep-BO1nweKv.mjs";
+import { A as ReadinessRegistry, C as asJsonObject, O as parseJsonUnknown, P as scopeKey, T as asString, a as adminUiCapability, b as DeviceType, gt as DisposerChain, ht as EventCategory, i as deviceOpsCapability, j as ReadinessTimeoutError, k as DATAPLANE_SECRET_HEADER, o as createDeviceProxy, ot as BaseAddon, p as expandCapMethods, st as normalizeAddonInitResult, t as sleep, ut as emitReadiness } from "./sleep-BiDFW0E7.mjs";
 import { t as errMsg } from "./err-msg-IQTHeDzc.mjs";
 export { BaseAddon, DATAPLANE_SECRET_HEADER, DeviceType, DisposerChain, EventCategory, ReadinessRegistry, ReadinessTimeoutError, adminUiCapability, asJsonObject, asString, createDeviceProxy, deviceOpsCapability, emitReadiness, errMsg, expandCapMethods, normalizeAddonInitResult, parseJsonUnknown, scopeKey, sleep };

package/dist/capabilities/camera-streams.cap.d.ts

@@ -116,8 +116,8 @@ export declare const cameraStreamsCapability: {
             sourceCamStreamId: z.ZodNullable<z.ZodString>;
             status: z.ZodEnum<{
                 error: "error";
-                idle: "idle";
                 unassigned: "unassigned";
+                idle: "idle";
                 connecting: "connecting";
                 streaming: "streaming";
             }>;
@@ -280,8 +280,8 @@ export declare const cameraStreamsCapability: {
                 sourceCamStreamId: z.ZodNullable<z.ZodString>;
                 status: z.ZodEnum<{
                     error: "error";
-                    idle: "idle";
                     unassigned: "unassigned";
+                    idle: "idle";
                     connecting: "connecting";
                     streaming: "streaming";
                 }>;
@@ -323,22 +323,22 @@ export declare const cameraStreamsCapability: {
         slotStatuses: z.ZodObject<{
             high: z.ZodOptional<z.ZodEnum<{
                 error: "error";
-                idle: "idle";
                 unassigned: "unassigned";
+                idle: "idle";
                 connecting: "connecting";
                 streaming: "streaming";
             }>>;
             mid: z.ZodOptional<z.ZodEnum<{
                 error: "error";
-                idle: "idle";
                 unassigned: "unassigned";
+                idle: "idle";
                 connecting: "connecting";
                 streaming: "streaming";
             }>>;
             low: z.ZodOptional<z.ZodEnum<{
                 error: "error";
-                idle: "idle";
                 unassigned: "unassigned";
+                idle: "idle";
                 connecting: "connecting";
                 streaming: "streaming";
             }>>;

package/dist/capabilities/decoder.cap.d.ts

@@ -109,6 +109,7 @@ export declare const decoderCapability: {
         readonly pullFrames: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
             sessionId: z.ZodString;
             maxCount: z.ZodDefault<z.ZodNumber>;
+            waitMs: z.ZodOptional<z.ZodNumber>;
         }, z.core.$strip>, z.ZodArray<z.ZodObject<{
             data: z.ZodCustom<Uint8Array<ArrayBuffer>, Uint8Array<ArrayBuffer>>;
             width: z.ZodNumber;
@@ -125,6 +126,7 @@ export declare const decoderCapability: {
         readonly pullHandles: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
             sessionId: z.ZodString;
             maxCount: z.ZodDefault<z.ZodNumber>;
+            waitMs: z.ZodOptional<z.ZodNumber>;
         }, z.core.$strip>, z.ZodArray<z.ZodObject<{
             shmId: z.ZodString;
             slot: z.ZodNumber;

package/dist/capabilities/index.d.ts

@@ -177,6 +177,7 @@ export { type ITemperatureSensorProvider, type TemperatureSensorStatus, Temperat
 export { type IToastProvider, ToastSchema, toastCapability } from './toast.cap.js';
 export { type IUpdateProvider, type UpdateStatus, UpdateStatusSchema, updateCapability, } from './update.cap.js';
 export { ApiKeySummarySchema, CreateApiKeyInputSchema, CreateApiKeyResultSchema, CreateScopedTokenInputSchema, CreateScopedTokenResultSchema, CreateUserInputSchema, type IUserManagementProvider, ScopedTokenSummarySchema, UpdateUserInputSchema, UserSummarySchema, userManagementCapability, } from './user-management.cap.js';
+export { type IPetFeederProvider, PET_FEEDER_MANUAL_FEED_MAX, PET_FEEDER_MANUAL_FEED_MIN, type PetFeederStatus, PetFeederStatusSchema, petFeederCapability, } from './pet-feeder.cap.js';
 export { type IVacuumControlProvider, type TankStatus, TankStatusSchema, type VacuumControlStatus, VacuumControlStatusSchema, type VacuumState, VacuumStateSchema, vacuumControlCapability, } from './vacuum-control.cap.js';
 export { type IValveProvider, type ValveState, ValveStateSchema, type ValveStatus, ValveStatusSchema, valveCapability, } from './valve.cap.js';
 export { type IVibrationProvider, type VibrationStatus, VibrationStatusSchema, vibrationCapability, } from './vibration.cap.js';
@@ -213,6 +214,7 @@ import type { cameraPipelineConfigCapability } from './camera-pipeline-config.ca
 import type { cameraStreamsCapability } from './camera-streams.cap.js';
 import type { carbonMonoxideCapability } from './carbon-monoxide.cap.js';
 import type { climateControlCapability } from './climate-control.cap.js';
+import type { petFeederCapability } from './pet-feeder.cap.js';
 import type { colorCapability } from './color.cap.js';
 import type { connectivityCapability } from './connectivity.cap.js';
 import type { consumablesCapability } from './consumables.cap.js';
@@ -306,6 +308,6 @@ import type { webrtcSessionCapability } from './webrtc-session.cap.js';
 import type { zoneAnalyticsCapability } from './zone-analytics.cap.js';
 import type { zoneRulesCapability } from './zone-rules.cap.js';
 import type { zonesCapability } from './zones.cap.js';
-type AnyCapability = typeof addonSettingsCapability | typeof alertsCapability | typeof storageCapability | typeof storageProviderCapability | typeof storageEvictableCapability | typeof filesystemBrowseCapability | typeof backupCapability | typeof settingsStoreCapability | typeof logDestinationCapability | typeof adminUiCapability | typeof ssoBridgeCapability | typeof userPasskeysCapability | typeof smtpProviderCapability | typeof mqttBrokerCapability | typeof brokerCapability | typeof deviceAdoptionCapability | typeof deviceExportCapability | typeof addonPagesCapability | typeof addonPagesSourceCapability | typeof addonWidgetsCapability | typeof addonWidgetsSourceCapability | typeof customModelRegistryCapability | typeof modelDistributorCapability | typeof modelConvertCapability | typeof addonRoutesCapability | typeof streamBrokerCapability | typeof decoderCapability | typeof restreamerCapability | typeof webrtcCapability | typeof webrtcSessionCapability | typeof cameraStreamsCapability | typeof streamingEngineCapability | typeof motionDetectionCapability | typeof pipelineExecutorCapability | typeof detectionPipelineCapability | typeof cameraPipelineConfigCapability | typeof pipelineRunnerCapability | typeof pipelineOrchestratorCapability | typeof audioAnalyzerCapability | typeof audioAnalysisCapability | typeof audioCodecCapability | typeof embeddingEncoderCapability | typeof deviceProviderCapability | typeof deviceManagerCapability | typeof deviceStateCapability | typeof authProviderCapability | typeof networkAccessCapability | typeof turnProviderCapability | typeof snapshotCapability | typeof snapshotProviderCapability | typeof notificationOutputCapability | typeof advancedNotifierCapability | typeof pipelineAnalyticsCapability | typeof metricsProviderCapability | typeof ptzCapability | typeof ptzAutotrackCapability | typeof consumablesCapability | typeof rebootCapability | typeof deviceDiscoveryCapability | typeof brightnessCapability | typeof colorCapability | typeof climateControlCapability | typeof coverCapability | typeof valveCapability | typeof humidifierCapability | typeof waterHeaterCapability | typeof weatherCapability | typeof imageCapability | typeof lockControlCapability | typeof vacuumControlCapability | typeof lawnMowerControlCapability | typeof fanControlCapability | typeof controlCapability | typeof notifierCapability | typeof mediaPlayerCapability | typeof alarmPanelCapability | typeof presenceCapability | typeof scriptRunnerCapability | typeof automationControlCapability | typeof motionTriggerCapability | typeof eventsCapability | typeof zonesCapability | typeof zoneRulesCapability | typeof zoneAnalyticsCapability | typeof audioMetricsCapability | typeof motionCapability | typeof contactCapability | typeof floodCapability | typeof smokeCapability | typeof carbonMonoxideCapability | typeof gasCapability | typeof tamperCapability | typeof vibrationCapability | typeof connectivityCapability | typeof binaryCapability | typeof temperatureSensorCapability | typeof humiditySensorCapability | typeof ambientLightSensorCapability | typeof pressureSensorCapability | typeof powerMeterCapability | typeof airQualitySensorCapability | typeof numericSensorCapability | typeof enumSensorCapability | typeof recordingCapability | typeof deviceOpsCapability | typeof platformProbeCapability | typeof localNetworkCapability | typeof meshNetworkCapability | typeof userManagementCapability | typeof systemCapability | typeof networkQualityCapability | typeof toastCapability | typeof nodesCapability | typeof integrationsCapability | typeof addonsCapability | typeof oauthIntegrationCapability | typeof streamParamsCapability | typeof streamCatalogCapability | typeof motionZonesCapability | typeof privacyMaskCapability;
+type AnyCapability = typeof addonSettingsCapability | typeof alertsCapability | typeof storageCapability | typeof storageProviderCapability | typeof storageEvictableCapability | typeof filesystemBrowseCapability | typeof backupCapability | typeof settingsStoreCapability | typeof logDestinationCapability | typeof adminUiCapability | typeof ssoBridgeCapability | typeof userPasskeysCapability | typeof smtpProviderCapability | typeof mqttBrokerCapability | typeof brokerCapability | typeof deviceAdoptionCapability | typeof deviceExportCapability | typeof addonPagesCapability | typeof addonPagesSourceCapability | typeof addonWidgetsCapability | typeof addonWidgetsSourceCapability | typeof customModelRegistryCapability | typeof modelDistributorCapability | typeof modelConvertCapability | typeof addonRoutesCapability | typeof streamBrokerCapability | typeof decoderCapability | typeof restreamerCapability | typeof webrtcCapability | typeof webrtcSessionCapability | typeof cameraStreamsCapability | typeof streamingEngineCapability | typeof motionDetectionCapability | typeof pipelineExecutorCapability | typeof detectionPipelineCapability | typeof cameraPipelineConfigCapability | typeof pipelineRunnerCapability | typeof pipelineOrchestratorCapability | typeof audioAnalyzerCapability | typeof audioAnalysisCapability | typeof audioCodecCapability | typeof embeddingEncoderCapability | typeof deviceProviderCapability | typeof deviceManagerCapability | typeof deviceStateCapability | typeof authProviderCapability | typeof networkAccessCapability | typeof turnProviderCapability | typeof snapshotCapability | typeof snapshotProviderCapability | typeof notificationOutputCapability | typeof advancedNotifierCapability | typeof pipelineAnalyticsCapability | typeof metricsProviderCapability | typeof ptzCapability | typeof ptzAutotrackCapability | typeof consumablesCapability | typeof rebootCapability | typeof deviceDiscoveryCapability | typeof brightnessCapability | typeof colorCapability | typeof climateControlCapability | typeof coverCapability | typeof valveCapability | typeof humidifierCapability | typeof waterHeaterCapability | typeof weatherCapability | typeof imageCapability | typeof lockControlCapability | typeof vacuumControlCapability | typeof petFeederCapability | typeof lawnMowerControlCapability | typeof fanControlCapability | typeof controlCapability | typeof notifierCapability | typeof mediaPlayerCapability | typeof alarmPanelCapability | typeof presenceCapability | typeof scriptRunnerCapability | typeof automationControlCapability | typeof motionTriggerCapability | typeof eventsCapability | typeof zonesCapability | typeof zoneRulesCapability | typeof zoneAnalyticsCapability | typeof audioMetricsCapability | typeof motionCapability | typeof contactCapability | typeof floodCapability | typeof smokeCapability | typeof carbonMonoxideCapability | typeof gasCapability | typeof tamperCapability | typeof vibrationCapability | typeof connectivityCapability | typeof binaryCapability | typeof temperatureSensorCapability | typeof humiditySensorCapability | typeof ambientLightSensorCapability | typeof pressureSensorCapability | typeof powerMeterCapability | typeof airQualitySensorCapability | typeof numericSensorCapability | typeof enumSensorCapability | typeof recordingCapability | typeof deviceOpsCapability | typeof platformProbeCapability | typeof localNetworkCapability | typeof meshNetworkCapability | typeof userManagementCapability | typeof systemCapability | typeof networkQualityCapability | typeof toastCapability | typeof nodesCapability | typeof integrationsCapability | typeof addonsCapability | typeof oauthIntegrationCapability | typeof streamParamsCapability | typeof streamCatalogCapability | typeof motionZonesCapability | typeof privacyMaskCapability;
 export type CapabilityName = AnyCapability['name'];
 export type ITypedReadinessRegistry = IReadinessRegistry<CapabilityName>;

package/dist/capabilities/metrics-provider.cap.d.ts

@@ -170,8 +170,8 @@ declare const AddonInstanceSchema: z.ZodObject<{
     pid: z.ZodNumber;
     state: z.ZodEnum<{
         running: "running";
-        starting: "starting";
         stopped: "stopped";
+        starting: "starting";
         stopping: "stopping";
         crashed: "crashed";
     }>;
@@ -466,8 +466,8 @@ export declare const metricsProviderCapability: {
             pid: z.ZodNumber;
             state: z.ZodEnum<{
                 running: "running";
-                starting: "starting";
                 stopped: "stopped";
+                starting: "starting";
                 stopping: "stopping";
                 crashed: "crashed";
             }>;

package/dist/capabilities/motion-detection.cap.d.ts

@@ -47,7 +47,7 @@ export declare const motionDetectionCapability: {
     readonly methods: {
         readonly analyze: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
             deviceId: z.ZodNumber;
-            frame: z.ZodObject<{
+            frame: z.ZodOptional<z.ZodObject<{
                 data: z.ZodCustom<Uint8Array<ArrayBufferLike>, Uint8Array<ArrayBufferLike>>;
                 format: z.ZodEnum<{
                     jpeg: "jpeg";
@@ -59,7 +59,25 @@ export declare const motionDetectionCapability: {
                 width: z.ZodNumber;
                 height: z.ZodNumber;
                 timestamp: z.ZodNumber;
-            }, z.core.$strip>;
+            }, z.core.$strip>>;
+            frameHandle: z.ZodOptional<z.ZodObject<{
+                shmId: z.ZodString;
+                slot: z.ZodNumber;
+                seq: z.ZodNumber;
+                width: z.ZodNumber;
+                height: z.ZodNumber;
+                format: z.ZodEnum<{
+                    jpeg: "jpeg";
+                    rgb: "rgb";
+                    bgr: "bgr";
+                    yuv420: "yuv420";
+                    gray: "gray";
+                }>;
+                pts: z.ZodNumber;
+                byteLength: z.ZodNumber;
+                nodeId: z.ZodString;
+                slotCount: z.ZodNumber;
+            }, z.core.$strip>>;
         }, z.core.$strip>, z.ZodObject<{
             detected: z.ZodBoolean;
             regionCount: z.ZodNumber;

package/dist/capabilities/pet-feeder.cap.d.ts

@@ -0,0 +1,185 @@
+import { z } from 'zod';
+import { type InferProvider } from './capability-definition.js';
+import { DeviceType } from '../device/device-type.js';
+/**
+ * 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). */
+export declare const PET_FEEDER_MANUAL_FEED_MIN = 4;
+export declare const 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.
+ */
+export declare const PetFeederDeviceStatusSchema: z.ZodEnum<{
+    offline: "offline";
+    normal: "normal";
+    on_batteries: "on_batteries";
+}>;
+export type PetFeederDeviceStatus = z.infer<typeof PetFeederDeviceStatusSchema>;
+export declare const PetFeederStatusSchema: z.ZodObject<{
+    foodLevel: z.ZodNullable<z.ZodNumber>;
+    food1: z.ZodNullable<z.ZodNumber>;
+    food2: z.ZodNullable<z.ZodNumber>;
+    lowFood: z.ZodBoolean;
+    batteryPower: z.ZodNullable<z.ZodNumber>;
+    desiccantLeftDays: z.ZodNullable<z.ZodNumber>;
+    feeding: z.ZodBoolean;
+    status: z.ZodNullable<z.ZodEnum<{
+        offline: "offline";
+        normal: "normal";
+        on_batteries: "on_batteries";
+    }>>;
+    error: z.ZodNullable<z.ZodString>;
+    errorCode: z.ZodNullable<z.ZodNumber>;
+    isDualHopper: z.ZodBoolean;
+    childLock: z.ZodBoolean;
+    indicatorLight: z.ZodBoolean;
+    feedSound: z.ZodBoolean;
+    volume: z.ZodNumber;
+    lastFetchedAt: z.ZodNumber;
+}, z.core.$strip>;
+export type PetFeederStatus = z.infer<typeof PetFeederStatusSchema>;
+export declare const petFeederCapability: {
+    readonly name: "pet-feeder";
+    readonly scope: "device";
+    readonly deviceNative: true;
+    readonly mode: "singleton";
+    readonly deviceTypes: readonly [DeviceType.PetFeeder];
+    readonly 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.
+         */
+        readonly feed: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
+            deviceId: z.ZodNumber;
+            grams: z.ZodOptional<z.ZodNumber>;
+            hopper1: z.ZodOptional<z.ZodNumber>;
+            hopper2: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>, z.ZodVoid, "mutation">;
+        /** Cancel an in-progress manual feed. */
+        readonly cancelFeed: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
+            deviceId: z.ZodNumber;
+        }, z.core.$strip>, z.ZodVoid, "mutation">;
+        /** Reset the desiccant "days remaining" counter after replacing it. */
+        readonly resetDesiccant: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
+            deviceId: z.ZodNumber;
+        }, z.core.$strip>, z.ZodVoid, "mutation">;
+        /** Mark a hopper as refilled (D4H/D4S/D4SH). */
+        readonly markFoodReplenished: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
+            deviceId: z.ZodNumber;
+        }, z.core.$strip>, z.ZodVoid, "mutation">;
+        /** Call the pet with the recorded prompt (D3). */
+        readonly callPet: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
+            deviceId: z.ZodNumber;
+        }, z.core.$strip>, z.ZodVoid, "mutation">;
+        /** Play a stored sound by id (D3 / D4H / D4SH). */
+        readonly playSound: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
+            deviceId: z.ZodNumber;
+            soundId: z.ZodNumber;
+        }, z.core.$strip>, z.ZodVoid, "mutation">;
+        /** Toggle the child-lock (manual-lock) setting. */
+        readonly setChildLock: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
+            deviceId: z.ZodNumber;
+            on: z.ZodBoolean;
+        }, z.core.$strip>, z.ZodVoid, "mutation">;
+        /** Toggle the front indicator light. */
+        readonly setIndicatorLight: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
+            deviceId: z.ZodNumber;
+            on: z.ZodBoolean;
+        }, z.core.$strip>, z.ZodVoid, "mutation">;
+        /** Toggle the dispense chime. */
+        readonly setFeedSound: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
+            deviceId: z.ZodNumber;
+            on: z.ZodBoolean;
+        }, z.core.$strip>, z.ZodVoid, "mutation">;
+        /** Set the speaker / prompt volume level. */
+        readonly setVolume: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
+            deviceId: z.ZodNumber;
+            level: z.ZodNumber;
+        }, z.core.$strip>, z.ZodVoid, "mutation">;
+    };
+    readonly status: {
+        readonly schema: z.ZodObject<{
+            foodLevel: z.ZodNullable<z.ZodNumber>;
+            food1: z.ZodNullable<z.ZodNumber>;
+            food2: z.ZodNullable<z.ZodNumber>;
+            lowFood: z.ZodBoolean;
+            batteryPower: z.ZodNullable<z.ZodNumber>;
+            desiccantLeftDays: z.ZodNullable<z.ZodNumber>;
+            feeding: z.ZodBoolean;
+            status: z.ZodNullable<z.ZodEnum<{
+                offline: "offline";
+                normal: "normal";
+                on_batteries: "on_batteries";
+            }>>;
+            error: z.ZodNullable<z.ZodString>;
+            errorCode: z.ZodNullable<z.ZodNumber>;
+            isDualHopper: z.ZodBoolean;
+            childLock: z.ZodBoolean;
+            indicatorLight: z.ZodBoolean;
+            feedSound: z.ZodBoolean;
+            volume: z.ZodNumber;
+            lastFetchedAt: z.ZodNumber;
+        }, z.core.$strip>;
+        readonly 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.
+     */
+    readonly runtimeState: z.ZodObject<{
+        foodLevel: z.ZodNullable<z.ZodNumber>;
+        food1: z.ZodNullable<z.ZodNumber>;
+        food2: z.ZodNullable<z.ZodNumber>;
+        lowFood: z.ZodBoolean;
+        batteryPower: z.ZodNullable<z.ZodNumber>;
+        desiccantLeftDays: z.ZodNullable<z.ZodNumber>;
+        feeding: z.ZodBoolean;
+        status: z.ZodNullable<z.ZodEnum<{
+            offline: "offline";
+            normal: "normal";
+            on_batteries: "on_batteries";
+        }>>;
+        error: z.ZodNullable<z.ZodString>;
+        errorCode: z.ZodNullable<z.ZodNumber>;
+        isDualHopper: z.ZodBoolean;
+        childLock: z.ZodBoolean;
+        indicatorLight: z.ZodBoolean;
+        feedSound: z.ZodBoolean;
+        volume: z.ZodNumber;
+        lastFetchedAt: z.ZodNumber;
+    }, z.core.$strip>;
+};
+export type IPetFeederProvider = InferProvider<typeof petFeederCapability>;

package/dist/capabilities/pipeline-executor.cap.d.ts

@@ -710,11 +710,20 @@ export declare const 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.
          */
@@ -748,6 +757,24 @@ export declare const pipelineExecutorCapability: {
                 height: z.ZodNumber;
                 timestamp: z.ZodNumber;
             }, z.core.$strip>>;
+            frameHandle: z.ZodOptional<z.ZodObject<{
+                shmId: z.ZodString;
+                slot: z.ZodNumber;
+                seq: z.ZodNumber;
+                width: z.ZodNumber;
+                height: z.ZodNumber;
+                format: z.ZodEnum<{
+                    jpeg: "jpeg";
+                    rgb: "rgb";
+                    bgr: "bgr";
+                    yuv420: "yuv420";
+                    gray: "gray";
+                }>;
+                pts: z.ZodNumber;
+                byteLength: z.ZodNumber;
+                nodeId: z.ZodString;
+                slotCount: z.ZodNumber;
+            }, z.core.$strip>>;
             imageBase64: z.ZodOptional<z.ZodString>;
             image: z.ZodOptional<z.ZodCustom<Uint8Array<ArrayBuffer>, Uint8Array<ArrayBuffer>>>;
             referenceImage: z.ZodOptional<z.ZodString>;

package/dist/capabilities/platform-probe.cap.d.ts

@@ -264,9 +264,9 @@ export declare const platformProbeCapability: {
                 directml: "directml";
                 webgpu: "webgpu";
             }>>>;
-            nodeId: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>, z.ZodObject<{
             preferred: z.ZodReadonly<z.ZodArray<z.ZodString>>;
+            rationale: z.ZodString;
         }, z.core.$strip>, import("./capability-definition.js").CapabilityMethodKind>;
         /**
          * Hardware-encoder probe — see Task #185. Cached after first call.

package/dist/capabilities/schemas/streaming-shared.d.ts

@@ -49,8 +49,8 @@ export declare const CameraStreamSchema: z.ZodObject<{
 export type CameraStream = z.infer<typeof CameraStreamSchema>;
 export declare const ProfileSlotStatusSchema: z.ZodEnum<{
     error: "error";
-    idle: "idle";
     unassigned: "unassigned";
+    idle: "idle";
     connecting: "connecting";
     streaming: "streaming";
 }>;
@@ -66,8 +66,8 @@ export declare const ProfileSlotSchema: z.ZodObject<{
     sourceCamStreamId: z.ZodNullable<z.ZodString>;
     status: z.ZodEnum<{
         error: "error";
-        idle: "idle";
         unassigned: "unassigned";
+        idle: "idle";
         connecting: "connecting";
         streaming: "streaming";
     }>;

package/dist/capabilities/stream-broker.cap.d.ts

@@ -413,8 +413,8 @@ export declare const streamBrokerCapability: {
             sourceCamStreamId: z.ZodNullable<z.ZodString>;
             status: z.ZodEnum<{
                 error: "error";
-                idle: "idle";
                 unassigned: "unassigned";
+                idle: "idle";
                 connecting: "connecting";
                 streaming: "streaming";
             }>;

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

@@ -81,7 +81,14 @@ export declare enum DeviceType {
     Container = "container",
     /** Single still-image entity (HA `image.*`). Read-only display of an
      *  `entity_picture` signed URL the browser loads directly. `image` cap. */
-    Image = "image"
+    Image = "image",
+    /** Smart pet feeder — cloud-connected food dispenser with a bowl food
+     *  level, battery, desiccant life, feeding state and manual-feed /
+     *  call-pet / maintenance actions. Installed with the `pet-feeder` cap;
+     *  dual-hopper models (D4S/D4SH) expose per-hopper portions. Sources:
+     *  native PetKit (`nodepetkit` `FeederDevice`), reusable by other feeder
+     *  integrations sharing the same food/desiccant/hopper surface. */
+    PetFeeder = "pet-feeder"
 }
 export declare enum DeviceFeature {
     BatteryOperated = "battery-operated",