@camstack/types 0.1.39 → 0.1.41

package/dist/capabilities/device-manager.cap.d.ts

@@ -35,10 +35,51 @@ export declare const DeviceInfoSchema: z.ZodObject<{
     parentDeviceId: z.ZodNullable<z.ZodNumber>;
     role: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     online: z.ZodBoolean;
+    probed: z.ZodOptional<z.ZodBoolean>;
     features: z.ZodArray<z.ZodString>;
     isCamera: z.ZodBoolean;
     config: z.ZodRecord<z.ZodString, z.ZodUnknown>;
     metadata: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+    sourceInfo: z.ZodOptional<z.ZodObject<{
+        id: z.ZodString;
+        system: z.ZodString;
+        uniqueId: z.ZodOptional<z.ZodString>;
+        raw: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$strip>>;
+    integrationId: z.ZodOptional<z.ZodString>;
+    linkDeviceId: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    primaryChildEntityId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    childLayout: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodObject<{
+        childKey: z.ZodString;
+        section: z.ZodString;
+        order: z.ZodOptional<z.ZodNumber>;
+        collapsed: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>>>>;
+    deviceLinks: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        source: z.ZodObject<{
+            sourceKey: z.ZodString;
+            cap: z.ZodString;
+            fieldPath: z.ZodString;
+        }, z.core.$strip>;
+        target: z.ZodObject<{
+            cap: z.ZodString;
+            fieldPath: z.ZodString;
+            itemKey: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>;
+        transform: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            kind: z.ZodLiteral<"identity">;
+        }, z.core.$strip>, z.ZodObject<{
+            kind: z.ZodLiteral<"enum-map">;
+            mapping: z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>;
+            fallback: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>;
+        }, z.core.$strip>, z.ZodObject<{
+            kind: z.ZodLiteral<"linear">;
+            scale: z.ZodNumber;
+            offset: z.ZodNumber;
+            clamp: z.ZodOptional<z.ZodReadonly<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>>>;
+        }, z.core.$strip>], "kind">>;
+    }, z.core.$strip>>>>;
 }, z.core.$strip>;
 export declare const ConfigEntrySchema: z.ZodObject<{
     key: z.ZodString;
@@ -70,6 +111,47 @@ export declare const DeviceMetaSchema: z.ZodObject<{
     disabled: z.ZodBoolean;
     parentDeviceId: z.ZodNullable<z.ZodNumber>;
     metadata: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+    sourceInfo: z.ZodOptional<z.ZodObject<{
+        id: z.ZodString;
+        system: z.ZodString;
+        uniqueId: z.ZodOptional<z.ZodString>;
+        raw: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$strip>>;
+    integrationId: z.ZodOptional<z.ZodString>;
+    linkDeviceId: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    primaryChildEntityId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    childLayout: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodObject<{
+        childKey: z.ZodString;
+        section: z.ZodString;
+        order: z.ZodOptional<z.ZodNumber>;
+        collapsed: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>>>>;
+    deviceLinks: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        source: z.ZodObject<{
+            sourceKey: z.ZodString;
+            cap: z.ZodString;
+            fieldPath: z.ZodString;
+        }, z.core.$strip>;
+        target: z.ZodObject<{
+            cap: z.ZodString;
+            fieldPath: z.ZodString;
+            itemKey: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>;
+        transform: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            kind: z.ZodLiteral<"identity">;
+        }, z.core.$strip>, z.ZodObject<{
+            kind: z.ZodLiteral<"enum-map">;
+            mapping: z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>;
+            fallback: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>;
+        }, z.core.$strip>, z.ZodObject<{
+            kind: z.ZodLiteral<"linear">;
+            scale: z.ZodNumber;
+            offset: z.ZodNumber;
+            clamp: z.ZodOptional<z.ZodReadonly<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>>>;
+        }, z.core.$strip>], "kind">>;
+    }, z.core.$strip>>>>;
+    role: z.ZodOptional<z.ZodNullable<z.ZodString>>;
 }, z.core.$strip>;
 export declare const DeviceRegisterPayloadSchema: z.ZodObject<{
     addonId: z.ZodString;
@@ -153,6 +235,47 @@ export declare const deviceManagerCapability: {
             disabled: z.ZodBoolean;
             parentDeviceId: z.ZodNullable<z.ZodNumber>;
             metadata: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+            sourceInfo: z.ZodOptional<z.ZodObject<{
+                id: z.ZodString;
+                system: z.ZodString;
+                uniqueId: z.ZodOptional<z.ZodString>;
+                raw: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            }, z.core.$strip>>;
+            integrationId: z.ZodOptional<z.ZodString>;
+            linkDeviceId: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+            primaryChildEntityId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            childLayout: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodObject<{
+                childKey: z.ZodString;
+                section: z.ZodString;
+                order: z.ZodOptional<z.ZodNumber>;
+                collapsed: z.ZodOptional<z.ZodBoolean>;
+            }, z.core.$strip>>>>;
+            deviceLinks: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                source: z.ZodObject<{
+                    sourceKey: z.ZodString;
+                    cap: z.ZodString;
+                    fieldPath: z.ZodString;
+                }, z.core.$strip>;
+                target: z.ZodObject<{
+                    cap: z.ZodString;
+                    fieldPath: z.ZodString;
+                    itemKey: z.ZodOptional<z.ZodString>;
+                }, z.core.$strip>;
+                transform: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+                    kind: z.ZodLiteral<"identity">;
+                }, z.core.$strip>, z.ZodObject<{
+                    kind: z.ZodLiteral<"enum-map">;
+                    mapping: z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>;
+                    fallback: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>;
+                }, z.core.$strip>, z.ZodObject<{
+                    kind: z.ZodLiteral<"linear">;
+                    scale: z.ZodNumber;
+                    offset: z.ZodNumber;
+                    clamp: z.ZodOptional<z.ZodReadonly<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>>>;
+                }, z.core.$strip>], "kind">>;
+            }, z.core.$strip>>>>;
+            role: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         }, z.core.$strip>>, import("./capability-definition.js").CapabilityMethodKind>;
         /** Update the operator-edited display name. Persists to the meta
          *  row + emits `EventCategory.DeviceMetaChanged`. */
@@ -166,6 +289,130 @@ export declare const deviceManagerCapability: {
             deviceId: z.ZodNumber;
             location: z.ZodNullable<z.ZodString>;
         }, z.core.$strip>, z.ZodVoid, "mutation">;
+        /** Update the device type. Writes the meta row, emits a
+         *  `DeviceMetaChanged` event. Used by the kernel to apply
+         *  `initialMeta.type` before device construction so the device
+         *  constructs with its real type instead of the allocateDeviceId
+         *  placeholder `'generic'`. */
+        readonly setType: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
+            deviceId: z.ZodNumber;
+            type: z.ZodEnum<typeof DeviceType>;
+        }, z.core.$strip>, z.ZodVoid, "mutation">;
+        /** Stamp (or update) the owning integration id on the device's meta
+         *  row. Called by the kernel's `create()` pre-seed path when
+         *  `initialMeta.integrationId` is set (analogous to `setName` /
+         *  `setType`). Idempotent. */
+        readonly setIntegrationId: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
+            deviceId: z.ZodNumber;
+            integrationId: z.ZodString;
+        }, z.core.$strip>, z.ZodVoid, "mutation">;
+        /** Stamp (or update) the soft-link device id on the device's meta
+         *  row. Called by the kernel `create()` pre-seed when
+         *  `initialMeta.linkDeviceId !== undefined`. Idempotent. */
+        readonly setLinkDeviceId: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
+            deviceId: z.ZodNumber;
+            linkDeviceId: z.ZodNullable<z.ZodNumber>;
+        }, z.core.$strip>, z.ZodVoid, "mutation">;
+        /** Set (or clear) the durable primary-child override on a CONTAINER
+         *  device's meta row, keyed on the chosen child's re-sync/rename-stable
+         *  `entityId`. Unlike `setLinkDeviceId` (numeric child id, goes stale on
+         *  re-sync), this survives a re-sync that reallocates the child's numeric
+         *  id. `null` clears the override → priority default. Idempotent. */
+        readonly setPrimaryChildEntityId: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
+            deviceId: z.ZodNumber;
+            primaryChildEntityId: z.ZodNullable<z.ZodString>;
+        }, z.core.$strip>, z.ZodVoid, "mutation">;
+        /** Set (or replace) the container-level `childLayout` on a device's meta
+         *  row — assigns specific child/accessory devices to named accordion
+         *  sections (with optional intra-section order). Mirrors
+         *  `setPrimaryChildEntityId`; the layout is parent-only. Persisted,
+         *  projected, and preserved across re-register/restore. Idempotent. */
+        readonly setChildLayout: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
+            deviceId: z.ZodNumber;
+            childLayout: z.ZodReadonly<z.ZodArray<z.ZodObject<{
+                childKey: z.ZodString;
+                section: z.ZodString;
+                order: z.ZodOptional<z.ZodNumber>;
+                collapsed: z.ZodOptional<z.ZodBoolean>;
+            }, z.core.$strip>>>;
+        }, z.core.$strip>, z.ZodVoid, "mutation">;
+        /** Set (or replace) the cross-device field wirings on a device's meta row.
+         *  Mirrors `setChildLayout`; persisted, projected, preserved across
+         *  re-register/restore. Idempotent. */
+        readonly setDeviceLinks: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
+            deviceId: z.ZodNumber;
+            deviceLinks: z.ZodReadonly<z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                source: z.ZodObject<{
+                    sourceKey: z.ZodString;
+                    cap: z.ZodString;
+                    fieldPath: z.ZodString;
+                }, z.core.$strip>;
+                target: z.ZodObject<{
+                    cap: z.ZodString;
+                    fieldPath: z.ZodString;
+                    itemKey: z.ZodOptional<z.ZodString>;
+                }, z.core.$strip>;
+                transform: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+                    kind: z.ZodLiteral<"identity">;
+                }, z.core.$strip>, z.ZodObject<{
+                    kind: z.ZodLiteral<"enum-map">;
+                    mapping: z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>;
+                    fallback: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>;
+                }, z.core.$strip>, z.ZodObject<{
+                    kind: z.ZodLiteral<"linear">;
+                    scale: z.ZodNumber;
+                    offset: z.ZodNumber;
+                    clamp: z.ZodOptional<z.ZodReadonly<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>>>;
+                }, z.core.$strip>], "kind">>;
+            }, z.core.$strip>>>;
+        }, z.core.$strip>, z.ZodVoid, "mutation">;
+        /** 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. */
+        readonly getWireableFields: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
+            deviceId: z.ZodNumber;
+        }, z.core.$strip>, z.ZodObject<{
+            caps: z.ZodReadonly<z.ZodArray<z.ZodObject<{
+                cap: z.ZodString;
+                fields: z.ZodReadonly<z.ZodArray<z.ZodObject<{
+                    path: z.ZodString;
+                    kind: z.ZodEnum<{
+                        string: "string";
+                        number: "number";
+                        boolean: "boolean";
+                        enum: "enum";
+                    }>;
+                    enumValues: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                }, z.core.$strip>>>;
+            }, z.core.$strip>>>;
+        }, z.core.$strip>, "query">;
+        /** Stamp (or update) the semantic role on the device's meta row.
+         *  Called by the kernel's `create()` / `spawnAccessoryChild` pre-seed
+         *  path when `initialMeta.role` is set (analogous to `setIntegrationId`).
+         *  Idempotent. `null` explicitly clears a previous role. */
+        readonly setRole: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
+            deviceId: z.ZodNumber;
+            role: z.ZodNullable<z.ZodString>;
+        }, z.core.$strip>, z.ZodVoid, "mutation">;
+        /** Batched meta pre-seed — applies every provided field to the device's
+         *  meta row in ONE settings round-trip (one lock acquisition, one
+         *  `deviceMeta` write) and emits one `DeviceMetaChanged` event per field
+         *  that was supplied. Each field carries the SAME semantics as its
+         *  individual setter (`setName` / `setLocation` / `setType` /
+         *  `setIntegrationId` / `setLinkDeviceId` / `setRole`) — omitted fields are
+         *  left untouched; `null` clears `location` / `linkDeviceId` / `role`.
+         *  Idempotent. Used by the kernel's `spawnAccessoryChild` flow to collapse
+         *  the per-child meta pre-seed (4-6 individual setter calls) into one,
+         *  which is the dominant cost when reconciling a many-entity container. */
+        readonly applyInitialMeta: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
+            deviceId: z.ZodNumber;
+            name: z.ZodOptional<z.ZodString>;
+            location: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            type: z.ZodOptional<z.ZodEnum<typeof DeviceType>>;
+            integrationId: z.ZodOptional<z.ZodString>;
+            linkDeviceId: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+            role: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        }, z.core.$strip>, z.ZodVoid, "mutation">;
         /** Patch the device's hardware-identity metadata blob. Merges
          *  `patch` over the current blob (shallow). Value `null` for a
          *  given key removes that key. Drivers populate factual fields
@@ -230,10 +477,51 @@ export declare const deviceManagerCapability: {
             parentDeviceId: z.ZodNullable<z.ZodNumber>;
             role: z.ZodOptional<z.ZodNullable<z.ZodString>>;
             online: z.ZodBoolean;
+            probed: z.ZodOptional<z.ZodBoolean>;
             features: z.ZodArray<z.ZodString>;
             isCamera: z.ZodBoolean;
             config: z.ZodRecord<z.ZodString, z.ZodUnknown>;
             metadata: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+            sourceInfo: z.ZodOptional<z.ZodObject<{
+                id: z.ZodString;
+                system: z.ZodString;
+                uniqueId: z.ZodOptional<z.ZodString>;
+                raw: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            }, z.core.$strip>>;
+            integrationId: z.ZodOptional<z.ZodString>;
+            linkDeviceId: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+            primaryChildEntityId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            childLayout: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodObject<{
+                childKey: z.ZodString;
+                section: z.ZodString;
+                order: z.ZodOptional<z.ZodNumber>;
+                collapsed: z.ZodOptional<z.ZodBoolean>;
+            }, z.core.$strip>>>>;
+            deviceLinks: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                source: z.ZodObject<{
+                    sourceKey: z.ZodString;
+                    cap: z.ZodString;
+                    fieldPath: z.ZodString;
+                }, z.core.$strip>;
+                target: z.ZodObject<{
+                    cap: z.ZodString;
+                    fieldPath: z.ZodString;
+                    itemKey: z.ZodOptional<z.ZodString>;
+                }, z.core.$strip>;
+                transform: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+                    kind: z.ZodLiteral<"identity">;
+                }, z.core.$strip>, z.ZodObject<{
+                    kind: z.ZodLiteral<"enum-map">;
+                    mapping: z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>;
+                    fallback: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>;
+                }, z.core.$strip>, z.ZodObject<{
+                    kind: z.ZodLiteral<"linear">;
+                    scale: z.ZodNumber;
+                    offset: z.ZodNumber;
+                    clamp: z.ZodOptional<z.ZodReadonly<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>>>;
+                }, z.core.$strip>], "kind">>;
+            }, z.core.$strip>>>>;
         }, z.core.$strip>>, import("./capability-definition.js").CapabilityMethodKind>;
         /** Get a single device by numeric deviceId. */
         readonly getDevice: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
@@ -249,10 +537,51 @@ export declare const deviceManagerCapability: {
             parentDeviceId: z.ZodNullable<z.ZodNumber>;
             role: z.ZodOptional<z.ZodNullable<z.ZodString>>;
             online: z.ZodBoolean;
+            probed: z.ZodOptional<z.ZodBoolean>;
             features: z.ZodArray<z.ZodString>;
             isCamera: z.ZodBoolean;
             config: z.ZodRecord<z.ZodString, z.ZodUnknown>;
             metadata: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+            sourceInfo: z.ZodOptional<z.ZodObject<{
+                id: z.ZodString;
+                system: z.ZodString;
+                uniqueId: z.ZodOptional<z.ZodString>;
+                raw: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            }, z.core.$strip>>;
+            integrationId: z.ZodOptional<z.ZodString>;
+            linkDeviceId: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+            primaryChildEntityId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            childLayout: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodObject<{
+                childKey: z.ZodString;
+                section: z.ZodString;
+                order: z.ZodOptional<z.ZodNumber>;
+                collapsed: z.ZodOptional<z.ZodBoolean>;
+            }, z.core.$strip>>>>;
+            deviceLinks: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                source: z.ZodObject<{
+                    sourceKey: z.ZodString;
+                    cap: z.ZodString;
+                    fieldPath: z.ZodString;
+                }, z.core.$strip>;
+                target: z.ZodObject<{
+                    cap: z.ZodString;
+                    fieldPath: z.ZodString;
+                    itemKey: z.ZodOptional<z.ZodString>;
+                }, z.core.$strip>;
+                transform: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+                    kind: z.ZodLiteral<"identity">;
+                }, z.core.$strip>, z.ZodObject<{
+                    kind: z.ZodLiteral<"enum-map">;
+                    mapping: z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>;
+                    fallback: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>;
+                }, z.core.$strip>, z.ZodObject<{
+                    kind: z.ZodLiteral<"linear">;
+                    scale: z.ZodNumber;
+                    offset: z.ZodNumber;
+                    clamp: z.ZodOptional<z.ZodReadonly<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>>>;
+                }, z.core.$strip>], "kind">>;
+            }, z.core.$strip>>>>;
         }, z.core.$strip>>, import("./capability-definition.js").CapabilityMethodKind>;
         /** List children of a parent device (by parent numeric id). */
         readonly getChildren: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
@@ -268,10 +597,51 @@ export declare const deviceManagerCapability: {
             parentDeviceId: z.ZodNullable<z.ZodNumber>;
             role: z.ZodOptional<z.ZodNullable<z.ZodString>>;
             online: z.ZodBoolean;
+            probed: z.ZodOptional<z.ZodBoolean>;
             features: z.ZodArray<z.ZodString>;
             isCamera: z.ZodBoolean;
             config: z.ZodRecord<z.ZodString, z.ZodUnknown>;
             metadata: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+            sourceInfo: z.ZodOptional<z.ZodObject<{
+                id: z.ZodString;
+                system: z.ZodString;
+                uniqueId: z.ZodOptional<z.ZodString>;
+                raw: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            }, z.core.$strip>>;
+            integrationId: z.ZodOptional<z.ZodString>;
+            linkDeviceId: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+            primaryChildEntityId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            childLayout: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodObject<{
+                childKey: z.ZodString;
+                section: z.ZodString;
+                order: z.ZodOptional<z.ZodNumber>;
+                collapsed: z.ZodOptional<z.ZodBoolean>;
+            }, z.core.$strip>>>>;
+            deviceLinks: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                source: z.ZodObject<{
+                    sourceKey: z.ZodString;
+                    cap: z.ZodString;
+                    fieldPath: z.ZodString;
+                }, z.core.$strip>;
+                target: z.ZodObject<{
+                    cap: z.ZodString;
+                    fieldPath: z.ZodString;
+                    itemKey: z.ZodOptional<z.ZodString>;
+                }, z.core.$strip>;
+                transform: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+                    kind: z.ZodLiteral<"identity">;
+                }, z.core.$strip>, z.ZodObject<{
+                    kind: z.ZodLiteral<"enum-map">;
+                    mapping: z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>;
+                    fallback: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>;
+                }, z.core.$strip>, z.ZodObject<{
+                    kind: z.ZodLiteral<"linear">;
+                    scale: z.ZodNumber;
+                    offset: z.ZodNumber;
+                    clamp: z.ZodOptional<z.ZodReadonly<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>>>;
+                }, z.core.$strip>], "kind">>;
+            }, z.core.$strip>>>>;
         }, z.core.$strip>>, import("./capability-definition.js").CapabilityMethodKind>;
         /** Get stream sources for a camera device. */
         readonly getStreamSources: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
@@ -338,6 +708,15 @@ export declare const deviceManagerCapability: {
         }, z.core.$strip>, z.ZodObject<{
             success: z.ZodLiteral<true>;
         }, z.core.$strip>, "mutation">;
+        /** Cascade-delete every top-level device whose `integrationId` matches.
+         *  Children cascade automatically via the per-parent remove path.
+         *  Idempotent: a device whose `integrationId` was never set never matches.
+         *  Returns the count of top-level parents actually removed. */
+        readonly removeByIntegration: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
+            integrationId: z.ZodString;
+        }, z.core.$strip>, z.ZodObject<{
+            removed: z.ZodNumber;
+        }, z.core.$strip>, "mutation">;
         /** Get quality→streamId mapping for a camera. Derived from profileHint if not explicitly set. */
         readonly getStreamProfileMap: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
             deviceId: z.ZodNumber;
@@ -556,6 +935,11 @@ export declare const deviceManagerCapability: {
                 }, z.core.$strip>>;
             }, z.core.$strip>>;
         }, z.core.$strip>, import("./capability-definition.js").CapabilityMethodKind>;
+        readonly runDeviceAction: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
+            deviceId: z.ZodNumber;
+            action: z.ZodString;
+            input: z.ZodUnknown;
+        }, z.core.$strip>, z.ZodUnknown, "mutation">;
         readonly updateDeviceField: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
             deviceId: z.ZodNumber;
             writerCapName: z.ZodString;
@@ -596,6 +980,12 @@ export declare const deviceManagerCapability: {
             type: z.ZodEnum<typeof DeviceType>;
             suggestedName: z.ZodString;
             prefilledConfig: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+            sourceInfo: z.ZodOptional<z.ZodObject<{
+                id: z.ZodString;
+                system: z.ZodString;
+                uniqueId: z.ZodOptional<z.ZodString>;
+                raw: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            }, z.core.$strip>>;
         }, z.core.$strip>>, "mutation">;
         /** Adopt a discovered device via the device-provider capability. */
         readonly adoptDevice: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
@@ -605,7 +995,14 @@ export declare const deviceManagerCapability: {
                 type: z.ZodEnum<typeof DeviceType>;
                 suggestedName: z.ZodString;
                 prefilledConfig: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+                sourceInfo: z.ZodOptional<z.ZodObject<{
+                    id: z.ZodString;
+                    system: z.ZodString;
+                    uniqueId: z.ZodOptional<z.ZodString>;
+                    raw: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                }, z.core.$strip>>;
             }, z.core.$strip>;
+            integrationId: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>, z.ZodObject<{
             id: z.ZodNumber;
             stableId: z.ZodString;
@@ -616,6 +1013,12 @@ export declare const deviceManagerCapability: {
             online: z.ZodBoolean;
             features: z.ZodArray<z.ZodString>;
             config: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+            sourceInfo: z.ZodOptional<z.ZodObject<{
+                id: z.ZodString;
+                system: z.ZodString;
+                uniqueId: z.ZodOptional<z.ZodString>;
+                raw: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            }, z.core.$strip>>;
         }, z.core.$strip>, "mutation">;
         /**
          * Get the creation form schema (ConfigUISchema) for a device type from a provider.
@@ -630,6 +1033,7 @@ export declare const deviceManagerCapability: {
             addonId: z.ZodString;
             type: z.ZodEnum<typeof DeviceType>;
             config: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+            integrationId: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>, z.ZodObject<{
             id: z.ZodNumber;
             stableId: z.ZodString;
@@ -640,6 +1044,12 @@ export declare const deviceManagerCapability: {
             online: z.ZodBoolean;
             features: z.ZodArray<z.ZodString>;
             config: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+            sourceInfo: z.ZodOptional<z.ZodObject<{
+                id: z.ZodString;
+                system: z.ZodString;
+                uniqueId: z.ZodOptional<z.ZodString>;
+                raw: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            }, z.core.$strip>>;
         }, z.core.$strip>, "mutation">;
         /**
          * Test a single form field value during device creation (no device
@@ -663,6 +1073,60 @@ export declare const deviceManagerCapability: {
             labels: z.ZodOptional<z.ZodArray<z.ZodString>>;
             error: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>, "mutation">;
+        /** List adoption candidates for an integration via its device-adoption provider. */
+        readonly adoptionListCandidates: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
+            integrationId: z.ZodString;
+            page: z.ZodDefault<z.ZodNumber>;
+            pageSize: z.ZodDefault<z.ZodNumber>;
+            filter: z.ZodOptional<z.ZodString>;
+            filterText: z.ZodOptional<z.ZodObject<{
+                search: z.ZodOptional<z.ZodString>;
+                area: z.ZodOptional<z.ZodString>;
+                manufacturer: z.ZodOptional<z.ZodString>;
+                adoptedOnly: z.ZodOptional<z.ZodBoolean>;
+                unadoptedOnly: z.ZodOptional<z.ZodBoolean>;
+            }, z.core.$strip>>;
+            addonId: z.ZodString;
+        }, z.core.$strip>, z.ZodObject<{
+            candidates: z.ZodReadonly<z.ZodArray<z.ZodType<import("./device-discovery.cap.js").DiscoveredChildDevice, unknown, z.core.$ZodTypeInternals<import("./device-discovery.cap.js").DiscoveredChildDevice, unknown>>>>;
+            totalCount: z.ZodNumber;
+            page: z.ZodNumber;
+            pageSize: z.ZodNumber;
+        }, z.core.$strip>, import("./capability-definition.js").CapabilityMethodKind>;
+        /** Trigger a discovery refresh on the integration's device-adoption provider. */
+        readonly adoptionRefresh: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
+            addonId: z.ZodString;
+            integrationId: z.ZodString;
+        }, z.core.$strip>, z.ZodObject<{
+            lastDiscoveryAt: z.ZodNullable<z.ZodNumber>;
+            candidateCount: z.ZodNumber;
+            adoptedCount: z.ZodNumber;
+            lastError: z.ZodNullable<z.ZodString>;
+        }, z.core.$strip>, "mutation">;
+        /** Adopt one or more discovered candidates via the device-adoption provider. */
+        readonly adoptionAdopt: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
+            integrationId: z.ZodString;
+            childNativeIds: z.ZodArray<z.ZodString>;
+            filter: z.ZodOptional<z.ZodString>;
+            importLocations: z.ZodOptional<z.ZodBoolean>;
+            perCandidate: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+                name: z.ZodOptional<z.ZodString>;
+                hiddenChildIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            }, z.core.$strip>>>;
+            addonId: z.ZodString;
+        }, z.core.$strip>, z.ZodObject<{
+            adopted: z.ZodReadonly<z.ZodArray<z.ZodObject<{
+                childNativeId: z.ZodString;
+                parentDeviceId: z.ZodNumber;
+                accessoryDeviceIds: z.ZodReadonly<z.ZodArray<z.ZodNumber>>;
+            }, z.core.$strip>>>;
+        }, z.core.$strip>, "mutation">;
+        /** Release an adopted parent device via the device-adoption provider. */
+        readonly adoptionRelease: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
+            integrationId: z.ZodString;
+            camDeviceId: z.ZodNumber;
+            addonId: z.ZodString;
+        }, z.core.$strip>, z.ZodVoid, "mutation">;
         /**
          * Test a field value on an existing device (e.g. probe an RTSP URL).
          * Routes through the device-provider for the owning addon.
@@ -706,4 +1170,9 @@ export declare const deviceManagerCapability: {
 };
 export type IDeviceManagerProvider = import('./capability-definition.js').InferProvider<typeof deviceManagerCapability>;
 export type DeviceInfo = z.infer<typeof DeviceInfoSchema>;
+/** Input shape for `device-manager.applyInitialMeta` — the batched meta
+ *  pre-seed the kernel's `spawnAccessoryChild` flow uses to collapse the
+ *  per-child meta setters into one round-trip. Inferred from the cap method's
+ *  Zod schema so the kernel caller and the addon impl share one source. */
+export type DeviceManagerApplyInitialMetaInput = z.infer<typeof deviceManagerCapability['methods']['applyInitialMeta']['input']>;
 //# sourceMappingURL=device-manager.cap.d.ts.map

package/dist/capabilities/device-manager.cap.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"device-manager.cap.d.ts","sourceRoot":"","sources":["../../src/capabilities/device-manager.cap.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAA;AACrD,OAAO,EAAE,uBAAuB,EAAE,MAAM,+BAA+B,CAAA;AAUvE;;;;GAIG;AACH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;iBA2B3B,CAAA;AAEF,eAAO,MAAM,iBAAiB;;;;iBAI5B,CAAA;AAEF,OAAO,EAAE,uBAAuB,EAAE,CAAA;AAElC,eAAO,MAAM,oBAAoB;;;;;;;;;iBAc/B,CAAA;AAEF;;;6EAG6E;AAC7E,eAAO,MAAM,gBAAgB;;;;;;;;;;iBAU3B,CAAA;AAgBF,eAAO,MAAM,2BAA2B;;;;;;;;;;;;iBAyBtC,CAAA;AAEF,eAAO,MAAM,yBAAyB;;iBAEpC,CAAA;AAEF,eAAO,MAAM,gCAAgC;;;iBAG3C,CAAA;AAIF,eAAO,MAAM,uBAAuB;;;;;QAOhC;;;6EAGqE;;;;;;;QAOrE,+FAA+F;;;;;;;;;;;;;;QAG/F,6FAA6F;;;;QAG7F,uEAAuE;;;;;QAGvE,kEAAkE;;;;QAMlE,iEAAiE;;;;QAMjE;;;kDAG0C;;;;;;;;;;;;;;QAM1C;6DACqD;;;;;QAOrD;yBACiB;;;;;QAOjB;;;;+DAIuD;;;;;QAUvD;;;;;0EAKkE;;QAMlE;;8CAEsC;;;;QAOtC;;;;yEAIiE;;;;;QAOjE;6DACqD;;;;;QAOrD,6DAA6D;;;;;;;;;;;;;QAQ7D,wEAAwE;;;;;;;;;;;;;;;;;;;QAMxE,+CAA+C;;;;;;;;;;;;;;;;;;;QAM/C,+DAA+D;;;;;;;;;;;;;;;;;;;QAQ/D,8CAA8C;;;;;;;;;;;;;;;;;;;;;;;;;;;;QAM9C,mEAAmE;;;;;;;;QAMnE,+EAA+E;;;;QAQ/E,mDAAmD;;;;;;;QAUnD,8DAA8D;;;;;;QAO9D,gEAAgE;;;;;;QAOhE,qGAAqG;;;;;;QASrG,iGAAiG;;;;QAMjG,wFAAwF;;;;;;;QAUxF,oGAAoG;;;;;;;;;;;QASpG;;;;WAIG;;;;;;;;;;;;;;;;QAeH;;;;;;;WAOG;;;;;;;;;;;;;;QAeH;;;;WAIG;;;;;;;QAYH;;;;;WAKG;;;;QAMH;;;;;;;;WAQG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;QAoCH;;;;;;;WAOG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;QAmBH;;;;;;WAMG;;;;;;;;;;;;;;;;;QA4BH,2DAA2D;;;;;;;;;QAO3D,oEAAoE;;;;;;;;;;;;;;;;;;;;QAUpE;;;WAGG;;;;;QASH,8DAA8D;;;;;;;;;;;;;;;;QAW9D;;;;;;;WAOG;;;;;;;;;;;;;;;QAaH;;;WAGG;;;;;;;;;;;;;QAWH;;;;;;;;;;;;;;;;;;WAkBG;;;;;;CASkC,CAAA;AAEzC,MAAM,MAAM,sBAAsB,GAAG,OAAO,4BAA4B,EAAE,aAAa,CAAC,OAAO,uBAAuB,CAAC,CAAA;AACvH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAA"}
+{"version":3,"file":"device-manager.cap.d.ts","sourceRoot":"","sources":["../../src/capabilities/device-manager.cap.ts"],"names":[],"mappings":"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"}

package/dist/capabilities/device-ops.cap.d.ts

@@ -1,8 +1,14 @@
 import { z } from 'zod';
 import { type InferProvider } from './capability-definition.js';
+export declare const RawStateResultSchema: z.ZodObject<{
+    source: z.ZodString;
+    data: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+}, z.core.$strip>;
+export type RawStateResult = z.infer<typeof RawStateResultSchema>;
 export declare const deviceOpsCapability: {
     readonly name: "device-ops";
     readonly scope: "device";
+    readonly deviceNative: true;
     readonly mode: "singleton";
     readonly methods: {
         /**
@@ -56,6 +62,17 @@ export declare const deviceOpsCapability: {
             deviceId: z.ZodNumber;
             values: z.ZodRecord<z.ZodString, z.ZodUnknown>;
         }, z.core.$strip>, z.ZodVoid, "mutation">;
+        /**
+         * Invoke a device custom action on a forked/remote device (the
+         * cross-process transport for `IDevice.runDeviceAction`). Mirrors
+         * `setConfig` — the device-manager calls this when the device is not
+         * hub-local.
+         */
+        readonly runAction: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
+            deviceId: z.ZodNumber;
+            action: z.ZodString;
+            input: z.ZodUnknown;
+        }, z.core.$strip>, z.ZodUnknown, "mutation">;
         /**
          * Invoke `IDevice.removeDevice()` so the driver can release resources
          * (close sockets, stop background tasks, …). The device-manager still
@@ -81,6 +98,19 @@ export declare const deviceOpsCapability: {
         readonly getSettingsSchema: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
             deviceId: z.ZodNumber;
         }, z.core.$strip>, z.ZodNullable<z.ZodUnknown>, import("./capability-definition.js").CapabilityMethodKind>;
+        /**
+         * Opt-in: return the device's RAW upstream state (the provider's
+         * cached values) as a display-safe `{ source, data }` blob. Returns
+         * `null` when the device exposes no raw state — the State panel hides
+         * its Raw toggle in that case. One-shot (read the provider's existing
+         * cache; no upstream round-trip).
+         */
+        readonly getRawState: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
+            deviceId: z.ZodNumber;
+        }, z.core.$strip>, z.ZodNullable<z.ZodObject<{
+            source: z.ZodString;
+            data: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        }, z.core.$strip>>, import("./capability-definition.js").CapabilityMethodKind>;
     };
 };
 export type IDeviceOpsProvider = InferProvider<typeof deviceOpsCapability>;