@camstack/types 1.2.46 → 1.2.48

package/dist/capabilities/notification-rules.cap.d.ts

@@ -99,10 +99,10 @@ export declare const NcOccupancyConditionSchema: z.ZodObject<{
     zoneId: z.ZodOptional<z.ZodString>;
     className: z.ZodOptional<z.ZodString>;
     op: z.ZodDefault<z.ZodEnum<{
-        "<=": "<=";
-        ">=": ">=";
         "became-occupied": "became-occupied";
         "became-free": "became-free";
+        ">=": ">=";
+        "<=": "<=";
     }>>;
     count: z.ZodDefault<z.ZodNumber>;
     sustainSeconds: z.ZodDefault<z.ZodNumber>;
@@ -358,10 +358,10 @@ export declare const NcConditionsSchema: z.ZodObject<{
         zoneId: z.ZodOptional<z.ZodString>;
         className: z.ZodOptional<z.ZodString>;
         op: z.ZodDefault<z.ZodEnum<{
-            "<=": "<=";
-            ">=": ">=";
             "became-occupied": "became-occupied";
             "became-free": "became-free";
+            ">=": ">=";
+            "<=": "<=";
         }>>;
         count: z.ZodDefault<z.ZodNumber>;
         sustainSeconds: z.ZodDefault<z.ZodNumber>;
@@ -525,10 +525,10 @@ export declare const NcRuleInputSchema: z.ZodObject<{
             zoneId: z.ZodOptional<z.ZodString>;
             className: z.ZodOptional<z.ZodString>;
             op: z.ZodDefault<z.ZodEnum<{
-                "<=": "<=";
-                ">=": ">=";
                 "became-occupied": "became-occupied";
                 "became-free": "became-free";
+                ">=": ">=";
+                "<=": "<=";
             }>>;
             count: z.ZodDefault<z.ZodNumber>;
             sustainSeconds: z.ZodDefault<z.ZodNumber>;
@@ -705,10 +705,10 @@ export declare const NcRulePatchSchema: z.ZodObject<{
             zoneId: z.ZodOptional<z.ZodString>;
             className: z.ZodOptional<z.ZodString>;
             op: z.ZodDefault<z.ZodEnum<{
-                "<=": "<=";
-                ">=": ">=";
                 "became-occupied": "became-occupied";
                 "became-free": "became-free";
+                ">=": ">=";
+                "<=": "<=";
             }>>;
             count: z.ZodDefault<z.ZodNumber>;
             sustainSeconds: z.ZodDefault<z.ZodNumber>;
@@ -878,10 +878,10 @@ export declare const NcRuleSchema: z.ZodObject<{
             zoneId: z.ZodOptional<z.ZodString>;
             className: z.ZodOptional<z.ZodString>;
             op: z.ZodDefault<z.ZodEnum<{
-                "<=": "<=";
-                ">=": ">=";
                 "became-occupied": "became-occupied";
                 "became-free": "became-free";
+                ">=": ">=";
+                "<=": "<=";
             }>>;
             count: z.ZodDefault<z.ZodNumber>;
             sustainSeconds: z.ZodDefault<z.ZodNumber>;
@@ -1371,10 +1371,10 @@ export declare const notificationRulesCapability: {
                         zoneId: z.ZodOptional<z.ZodString>;
                         className: z.ZodOptional<z.ZodString>;
                         op: z.ZodDefault<z.ZodEnum<{
-                            "<=": "<=";
-                            ">=": ">=";
                             "became-occupied": "became-occupied";
                             "became-free": "became-free";
+                            ">=": ">=";
+                            "<=": "<=";
                         }>>;
                         count: z.ZodDefault<z.ZodNumber>;
                         sustainSeconds: z.ZodDefault<z.ZodNumber>;
@@ -1550,10 +1550,10 @@ export declare const notificationRulesCapability: {
                         zoneId: z.ZodOptional<z.ZodString>;
                         className: z.ZodOptional<z.ZodString>;
                         op: z.ZodDefault<z.ZodEnum<{
-                            "<=": "<=";
-                            ">=": ">=";
                             "became-occupied": "became-occupied";
                             "became-free": "became-free";
+                            ">=": ">=";
+                            "<=": "<=";
                         }>>;
                         count: z.ZodDefault<z.ZodNumber>;
                         sustainSeconds: z.ZodDefault<z.ZodNumber>;
@@ -1727,10 +1727,10 @@ export declare const notificationRulesCapability: {
                         zoneId: z.ZodOptional<z.ZodString>;
                         className: z.ZodOptional<z.ZodString>;
                         op: z.ZodDefault<z.ZodEnum<{
-                            "<=": "<=";
-                            ">=": ">=";
                             "became-occupied": "became-occupied";
                             "became-free": "became-free";
+                            ">=": ">=";
+                            "<=": "<=";
                         }>>;
                         count: z.ZodDefault<z.ZodNumber>;
                         sustainSeconds: z.ZodDefault<z.ZodNumber>;
@@ -1898,10 +1898,10 @@ export declare const notificationRulesCapability: {
                         zoneId: z.ZodOptional<z.ZodString>;
                         className: z.ZodOptional<z.ZodString>;
                         op: z.ZodDefault<z.ZodEnum<{
-                            "<=": "<=";
-                            ">=": ">=";
                             "became-occupied": "became-occupied";
                             "became-free": "became-free";
+                            ">=": ">=";
+                            "<=": "<=";
                         }>>;
                         count: z.ZodDefault<z.ZodNumber>;
                         sustainSeconds: z.ZodDefault<z.ZodNumber>;
@@ -2078,10 +2078,10 @@ export declare const notificationRulesCapability: {
                         zoneId: z.ZodOptional<z.ZodString>;
                         className: z.ZodOptional<z.ZodString>;
                         op: z.ZodDefault<z.ZodEnum<{
-                            "<=": "<=";
-                            ">=": ">=";
                             "became-occupied": "became-occupied";
                             "became-free": "became-free";
+                            ">=": ">=";
+                            "<=": "<=";
                         }>>;
                         count: z.ZodDefault<z.ZodNumber>;
                         sustainSeconds: z.ZodDefault<z.ZodNumber>;
@@ -2250,10 +2250,10 @@ export declare const notificationRulesCapability: {
                         zoneId: z.ZodOptional<z.ZodString>;
                         className: z.ZodOptional<z.ZodString>;
                         op: z.ZodDefault<z.ZodEnum<{
-                            "<=": "<=";
-                            ">=": ">=";
                             "became-occupied": "became-occupied";
                             "became-free": "became-free";
+                            ">=": ">=";
+                            "<=": "<=";
                         }>>;
                         count: z.ZodDefault<z.ZodNumber>;
                         sustainSeconds: z.ZodDefault<z.ZodNumber>;
@@ -2475,10 +2475,10 @@ export declare const notificationRulesCapability: {
                         zoneId: z.ZodOptional<z.ZodString>;
                         className: z.ZodOptional<z.ZodString>;
                         op: z.ZodDefault<z.ZodEnum<{
-                            "<=": "<=";
-                            ">=": ">=";
                             "became-occupied": "became-occupied";
                             "became-free": "became-free";
+                            ">=": ">=";
+                            "<=": "<=";
                         }>>;
                         count: z.ZodDefault<z.ZodNumber>;
                         sustainSeconds: z.ZodDefault<z.ZodNumber>;

package/dist/capabilities/oauth-integration.cap.d.ts

@@ -47,6 +47,8 @@ declare const OauthIntegrationDescriptorSchema: z.ZodObject<{
         }>>;
     }, z.core.$strip>], "type">>;
     allowedRedirectPrefixes: z.ZodArray<z.ZodString>;
+    allowedPrivateHostPaths: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    requiresPkce: z.ZodOptional<z.ZodBoolean>;
     hubUrl: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 export declare const oauthIntegrationCapability: {
@@ -95,6 +97,8 @@ export declare const oauthIntegrationCapability: {
                 }>>;
             }, z.core.$strip>], "type">>;
             allowedRedirectPrefixes: z.ZodArray<z.ZodString>;
+            allowedPrivateHostPaths: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            requiresPkce: z.ZodOptional<z.ZodBoolean>;
             hubUrl: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>, import("./capability-definition.js").CapabilityMethodKind>;
     };

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

@@ -133,10 +133,10 @@ export declare const OsdSlotBindingSchema: z.ZodObject<{
             zoneId: z.ZodOptional<z.ZodString>;
             className: z.ZodOptional<z.ZodString>;
             op: z.ZodDefault<z.ZodEnum<{
-                "<=": "<=";
-                ">=": ">=";
                 "became-occupied": "became-occupied";
                 "became-free": "became-free";
+                ">=": ">=";
+                "<=": "<=";
             }>>;
             count: z.ZodDefault<z.ZodNumber>;
             sustainSeconds: z.ZodDefault<z.ZodNumber>;
@@ -242,10 +242,10 @@ export declare const OsdSlotViewSchema: z.ZodObject<{
                 zoneId: z.ZodOptional<z.ZodString>;
                 className: z.ZodOptional<z.ZodString>;
                 op: z.ZodDefault<z.ZodEnum<{
-                    "<=": "<=";
-                    ">=": ">=";
                     "became-occupied": "became-occupied";
                     "became-free": "became-free";
+                    ">=": ">=";
+                    "<=": "<=";
                 }>>;
                 count: z.ZodDefault<z.ZodNumber>;
                 sustainSeconds: z.ZodDefault<z.ZodNumber>;
@@ -423,10 +423,10 @@ export declare const osdManagerCapability: {
                             zoneId: z.ZodOptional<z.ZodString>;
                             className: z.ZodOptional<z.ZodString>;
                             op: z.ZodDefault<z.ZodEnum<{
-                                "<=": "<=";
-                                ">=": ">=";
                                 "became-occupied": "became-occupied";
                                 "became-free": "became-free";
+                                ">=": ">=";
+                                "<=": "<=";
                             }>>;
                             count: z.ZodDefault<z.ZodNumber>;
                             sustainSeconds: z.ZodDefault<z.ZodNumber>;
@@ -615,10 +615,10 @@ export declare const osdManagerCapability: {
                         zoneId: z.ZodOptional<z.ZodString>;
                         className: z.ZodOptional<z.ZodString>;
                         op: z.ZodDefault<z.ZodEnum<{
-                            "<=": "<=";
-                            ">=": ">=";
                             "became-occupied": "became-occupied";
                             "became-free": "became-free";
+                            ">=": ">=";
+                            "<=": "<=";
                         }>>;
                         count: z.ZodDefault<z.ZodNumber>;
                         sustainSeconds: z.ZodDefault<z.ZodNumber>;
@@ -723,10 +723,10 @@ export declare const osdManagerCapability: {
                             zoneId: z.ZodOptional<z.ZodString>;
                             className: z.ZodOptional<z.ZodString>;
                             op: z.ZodDefault<z.ZodEnum<{
-                                "<=": "<=";
-                                ">=": ">=";
                                 "became-occupied": "became-occupied";
                                 "became-free": "became-free";
+                                ">=": ">=";
+                                "<=": "<=";
                             }>>;
                             count: z.ZodDefault<z.ZodNumber>;
                             sustainSeconds: z.ZodDefault<z.ZodNumber>;
@@ -851,10 +851,10 @@ export declare const osdManagerCapability: {
                         zoneId: z.ZodOptional<z.ZodString>;
                         className: z.ZodOptional<z.ZodString>;
                         op: z.ZodDefault<z.ZodEnum<{
-                            "<=": "<=";
-                            ">=": ">=";
                             "became-occupied": "became-occupied";
                             "became-free": "became-free";
+                            ">=": ">=";
+                            "<=": "<=";
                         }>>;
                         count: z.ZodDefault<z.ZodNumber>;
                         sustainSeconds: z.ZodDefault<z.ZodNumber>;

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

@@ -202,7 +202,7 @@ export type TrackEnvelope = z.infer<typeof TrackEnvelopeSchema>;
  * `snapshots[]` references — megabytes across a page of tracks. `slim`
  * keeps every scalar the list surfaces actually render (ids, class(es),
  * label / audioLabels / importance enrichment, firstSeen/lastSeen, state,
- * zonesVisited, bestEventId, envelope) and returns `positions` /
+ * zonesVisited, bestEventId, envelope, hasFace) and returns `positions` /
  * `snapshots` as EMPTY arrays — detail views re-fetch the full row via
  * `getTrack`. Mirrors the event-store `projection` convention
  * (`getObjectEvents` et al.).
@@ -429,6 +429,7 @@ declare const TrackSchema: z.ZodObject<{
         maxX: z.ZodNumber;
         maxY: z.ZodNumber;
     }, z.core.$strip>>;
+    hasFace: z.ZodOptional<z.ZodBoolean>;
     label: z.ZodOptional<z.ZodString>;
     labelScore: z.ZodOptional<z.ZodNumber>;
     labelMeta: z.ZodOptional<z.ZodObject<{
@@ -1072,6 +1073,7 @@ declare const RecentTracksPageSchema: z.ZodObject<{
             maxX: z.ZodNumber;
             maxY: z.ZodNumber;
         }, z.core.$strip>>;
+        hasFace: z.ZodOptional<z.ZodBoolean>;
         label: z.ZodOptional<z.ZodString>;
         labelScore: z.ZodOptional<z.ZodNumber>;
         labelMeta: z.ZodOptional<z.ZodObject<{
@@ -1315,6 +1317,7 @@ export declare const pipelineAnalyticsCapability: {
                 maxX: z.ZodNumber;
                 maxY: z.ZodNumber;
             }, z.core.$strip>>;
+            hasFace: z.ZodOptional<z.ZodBoolean>;
             label: z.ZodOptional<z.ZodString>;
             labelScore: z.ZodOptional<z.ZodNumber>;
             labelMeta: z.ZodOptional<z.ZodObject<{
@@ -1405,6 +1408,7 @@ export declare const pipelineAnalyticsCapability: {
                 maxX: z.ZodNumber;
                 maxY: z.ZodNumber;
             }, z.core.$strip>>;
+            hasFace: z.ZodOptional<z.ZodBoolean>;
             label: z.ZodOptional<z.ZodString>;
             labelScore: z.ZodOptional<z.ZodNumber>;
             labelMeta: z.ZodOptional<z.ZodObject<{
@@ -1517,6 +1521,7 @@ export declare const pipelineAnalyticsCapability: {
                 maxX: z.ZodNumber;
                 maxY: z.ZodNumber;
             }, z.core.$strip>>;
+            hasFace: z.ZodOptional<z.ZodBoolean>;
             label: z.ZodOptional<z.ZodString>;
             labelScore: z.ZodOptional<z.ZodNumber>;
             labelMeta: z.ZodOptional<z.ZodObject<{
@@ -1625,6 +1630,7 @@ export declare const pipelineAnalyticsCapability: {
                     maxX: z.ZodNumber;
                     maxY: z.ZodNumber;
                 }, z.core.$strip>>;
+                hasFace: z.ZodOptional<z.ZodBoolean>;
                 label: z.ZodOptional<z.ZodString>;
                 labelScore: z.ZodOptional<z.ZodNumber>;
                 labelMeta: z.ZodOptional<z.ZodObject<{

package/dist/capabilities/sso-bridge.cap.d.ts

@@ -61,6 +61,7 @@ declare const SsoBridgeClaimsSchema: z.ZodObject<{
     redirectUri: z.ZodOptional<z.ZodString>;
     integrationId: z.ZodOptional<z.ZodString>;
     jti: z.ZodOptional<z.ZodString>;
+    codeChallenge: z.ZodOptional<z.ZodString>;
     sessionId: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 export declare const ssoBridgeCapability: {
@@ -117,6 +118,7 @@ export declare const ssoBridgeCapability: {
                 redirectUri: z.ZodOptional<z.ZodString>;
                 integrationId: z.ZodOptional<z.ZodString>;
                 jti: z.ZodOptional<z.ZodString>;
+                codeChallenge: z.ZodOptional<z.ZodString>;
                 sessionId: z.ZodOptional<z.ZodString>;
             }, z.core.$strip>;
             ttlSec: z.ZodOptional<z.ZodNumber>;
@@ -172,6 +174,7 @@ export declare const ssoBridgeCapability: {
             redirectUri: z.ZodOptional<z.ZodString>;
             integrationId: z.ZodOptional<z.ZodString>;
             jti: z.ZodOptional<z.ZodString>;
+            codeChallenge: z.ZodOptional<z.ZodString>;
             sessionId: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>>, import("./capability-definition.js").CapabilityMethodKind>;
     };

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

@@ -727,6 +727,7 @@ export declare const streamBrokerCapability: {
             }>>>;
             gifMaxWidth: z.ZodDefault<z.ZodNumber>;
             gifFps: z.ZodDefault<z.ZodNumber>;
+            gifSpeed: z.ZodDefault<z.ZodNumber>;
             speed: z.ZodDefault<z.ZodNumber>;
         }, z.core.$strip>, z.ZodObject<{
             media: z.ZodReadonly<z.ZodArray<z.ZodObject<{

package/dist/capabilities/user-management.cap.d.ts

@@ -937,12 +937,14 @@ export declare const userManagementCapability: {
             }, z.core.$strip>], "type">>;
             redirectUri: z.ZodString;
             hubUrl: z.ZodString;
+            codeChallenge: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>, z.ZodObject<{
             code: z.ZodString;
         }, z.core.$strip>, "mutation">;
         readonly oauthExchangeCode: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
             code: z.ZodString;
             redirectUri: z.ZodString;
+            codeVerifier: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>, z.ZodNullable<z.ZodObject<{
             accessToken: z.ZodString;
             refreshToken: z.ZodString;
@@ -1050,4 +1052,4 @@ export declare const userManagementCapability: {
     };
 };
 export type IUserManagementProvider = InferProvider<typeof userManagementCapability>;
-export { UserSummarySchema, CreateUserInputSchema, UpdateUserInputSchema, ApiKeySummarySchema, CreateApiKeyInputSchema, CreateApiKeyResultSchema, ScopedTokenSummarySchema, CreateScopedTokenInputSchema, CreateScopedTokenResultSchema, OauthSessionSummarySchema, };
+export { ApiKeySummarySchema, CreateApiKeyInputSchema, CreateApiKeyResultSchema, CreateScopedTokenInputSchema, CreateScopedTokenResultSchema, CreateUserInputSchema, OauthSessionSummarySchema, ScopedTokenSummarySchema, UpdateUserInputSchema, UserSummarySchema, };

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

@@ -1,4 +1,5 @@
 import { z } from 'zod';
+import { DeviceType } from '../device/device-type.js';
 import { type InferProvider } from './capability-definition.js';
 /**
  * `videoclips` — the unified, navigable-clip surface for a camera.
@@ -42,6 +43,10 @@ export declare const videoclipsCapability: {
     readonly mode: "singleton";
     readonly kind: "wrapper";
     readonly defaultActive: true;
+    /** A clip is a window over a camera's footage — the cap is meaningless on a
+     *  sensor, a button or an event emitter, and the `defaultActive` auto-bind
+     *  reads this to decide which devices it may claim. */
+    readonly deviceTypes: readonly [DeviceType.Camera];
     readonly methods: {
         readonly listClips: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
             deviceId: z.ZodNumber;

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

@@ -0,0 +1,197 @@
+/**
+ * Declared devices — the ownership primitive for a device an addon DECLARES
+ * rather than discovers.
+ *
+ * A provider adopts what a vendor reports. A *declaration* is the other shape:
+ * a device exists because an addon says so, in code, on every boot. The NC
+ * alarm panel is the live instance of it (device 1023) and, until this module,
+ * the only one — hand-rolled inline with eight injected dependencies.
+ *
+ * What this owns, and why each part is here rather than at the call site:
+ *
+ * - **Idempotence.** `reconcile` is `get-or-create` on `(addonId, stableId)`
+ *   and is safe to run on every boot and on every convergence tick. Nothing
+ *   here is one-shot.
+ * - **Reconcile, not one-shot (D49).** The destructive branch — "the index does
+ *   not list it, so CREATE it with its declared meta" — re-stamps the declared
+ *   name over an operator's rename. It therefore requires a SECOND read of the
+ *   index to agree before it runs. A read that fails changes nothing at all:
+ *   the pass aborts, and the next one converges.
+ * - **The name follows the authority.** A declared device's name is seeded ONCE,
+ *   at create. Every later pass adopts without meta, because a rename belongs to
+ *   the operator and re-stamping it every boot is the losing half of two writers
+ *   (D62).
+ * - **`fixed` is re-asserted every pass.** The defect the hand-rolled version
+ *   shipped with wrote `info.fixed` only on the create path, so an install that
+ *   already had the integration never received the flag — the kernel kept
+ *   allowing its deletion. Get-or-create is not enough for a flag; it has to be
+ *   re-asserted.
+ * - **Withdrawal is cleanup.** A declaration removed from the code removes its
+ *   device, bounded to the addon's own FIXED integration and logged per device.
+ *   Nothing outside that integration is ever touched.
+ * - **One owner node.** An addon that runs on every node must not race to own a
+ *   cluster singleton. The default placement is `'hub'`.
+ *
+ * What this deliberately does NOT own: writing a declared device's STATE. The
+ * authority for a cap slice is already `deviceState.setCapSlice` (via
+ * `BaseDevice.runtimeState` / `ctx.fetchDevice(id)`). A third alias for it would
+ * be a second writer of a value that already has one.
+ */
+import type { IScopedLogger } from '../interfaces/logging.js';
+import type { IDevice } from './device.js';
+import type { DeviceConstructor, DeviceManagerApi } from './device-context.js';
+import type { DeviceType } from './device-type.js';
+/** Marker written to a declared integration's `info`. */
+export declare const DECLARED_INTEGRATION_FIXED_KEY = "fixed";
+/** One row of the addon's own device index, as `deviceManager.listAll` reports it. */
+export interface DeclaredDeviceRow {
+    readonly id: number;
+    readonly stableId: string;
+    readonly integrationId?: string | null;
+}
+/** An integration as the integrations store reports it. */
+export interface DeclaredIntegrationRow {
+    readonly id: string;
+    readonly info?: Record<string, unknown> | null;
+}
+/**
+ * The narrow surface `DeclaredDevices` drives.
+ *
+ * Ports rather than a whole `AddonContext` for one reason that has cost this
+ * repo twice: a fake of the whole context supplies values production forgets to
+ * fetch. Five named operations can be faked without inventing behaviour.
+ */
+export interface DeclaredDevicePorts {
+    readonly logger: IScopedLogger;
+    /** The declaring addon's id — the owner half of `(addonId, stableId)`. */
+    readonly addonId: string;
+    /** `ctx.kernel.devices`. */
+    readonly devices: DeviceManagerApi;
+    /** `ctx.kernel.localNodeId`. A forked child reads `<node>/<addon>`. */
+    readonly localNodeId?: string | undefined;
+    /** `integrations.getByAddonId` — null when this addon has none yet. */
+    readonly getIntegration: (addonId: string) => Promise<DeclaredIntegrationRow | null>;
+    readonly createIntegration: (input: {
+        addonId: string;
+        name: string;
+        info: Record<string, unknown>;
+    }) => Promise<{
+        readonly id: string;
+    }>;
+    /** Merge `info` onto an EXISTING integration. Used to re-assert `fixed`. */
+    readonly updateIntegration: (input: {
+        id: string;
+        info: Record<string, unknown>;
+    }) => Promise<void>;
+    /**
+     * Every device row this addon owns.
+     *
+     * FALLIBLE on purpose: this is the read the D49 discipline applies to. It may
+     * throw, and it may transiently answer `[]` while the registry is cold — which
+     * is indistinguishable from "the operator deleted everything".
+     */
+    readonly listOwnDevices: () => Promise<readonly DeclaredDeviceRow[]>;
+}
+/** One device an addon declares. */
+export interface DeviceDeclaration<T extends IDevice = IDevice> {
+    /** Stable within the addon, never derived from the name — a rename must not
+     *  mint a second device. */
+    readonly stableId: string;
+    /** Seeded ONCE, at create. Never re-stamped (D62). */
+    readonly name: string;
+    readonly type: DeviceType;
+    readonly DeviceClass: DeviceConstructor<T>;
+    /** Initial config blob, written before the constructor runs. Create only. */
+    readonly config?: Record<string, unknown>;
+    /** Optional semantic role, stamped at create alongside the type. */
+    readonly role?: string;
+}
+/** Where the declaration is owned. */
+export type DeclarationPlacement = 'hub' | 'this-node';
+export interface DeclaredDevicesSpec {
+    /** Display name of the FIXED integration the devices hang from. */
+    readonly integrationName: string;
+    readonly devices: readonly DeviceDeclaration[];
+    /**
+     * Default `'hub'`: a declaration is cluster state and belongs to the node
+     * that is always there. `'this-node'` is for a declaration that is genuinely
+     * per-node.
+     */
+    readonly placement?: DeclarationPlacement;
+}
+export interface DeclaredDeviceOutcome {
+    readonly stableId: string;
+    readonly deviceId: number;
+    readonly device: IDevice;
+    /** True only on the boot that created it — the operator sees one line, once. */
+    readonly created: boolean;
+}
+export interface DeclaredDevicesResult {
+    /** Null when this node does not own the declaration (see `placement`). */
+    readonly integrationId: string | null;
+    readonly devices: readonly DeclaredDeviceOutcome[];
+    /** Device ids removed because their declaration was withdrawn. */
+    readonly removed: readonly number[];
+    /** False when the placement gate skipped this node entirely. */
+    readonly owned: boolean;
+}
+/**
+ * Strip the `<node>/<addon>` suffix a forked child carries.
+ *
+ * Comparing `ctx.kernel.localNodeId` raw skipped EVERY node — including the one
+ * that was supposed to act — because on the hub it reads `hub/<addon>`.
+ */
+export declare function declarationOwnerNodeId(localNodeId: string | undefined): string;
+/** Cap on how many rows one withdrawal pass may delete. */
+export declare const DECLARED_DEVICE_SWEEP_LIMIT = 32;
+/**
+ * The one way an addon owns a device it declares.
+ *
+ * Construct once with the addon's ports, then call {@link reconcile} on boot and
+ * on every convergence tick. There is no second get-or-create helper — a guard
+ * in `scripts/` enforces that.
+ */
+export declare class DeclaredDevices {
+    private readonly ports;
+    constructor(ports: DeclaredDevicePorts);
+    /**
+     * Converge the declared set. Idempotent, and safe to call repeatedly.
+     *
+     * Throws only what the ports throw on the FIRST index read; every other
+     * failure is per-device and logged, so one bad declaration never takes the
+     * others down.
+     */
+    reconcile(spec: DeclaredDevicesSpec): Promise<DeclaredDevicesResult>;
+    /**
+     * Get-or-create the FIXED integration, and RE-ASSERT the flag every pass.
+     *
+     * The re-assertion is the fix for the defect the hand-rolled version shipped
+     * with: writing `info.fixed` only on the create path left every pre-existing
+     * install without it, and the kernel kept offering to delete an integration
+     * the addon owns.
+     */
+    private ensureIntegration;
+    private readIndex;
+    /**
+     * One declaration: adopt what exists, create what does not.
+     *
+     * The create branch is the destructive one — it seeds `initialMeta`, and
+     * `initialMeta.name` lands as an unconditional `setName`. A transiently empty
+     * index therefore looks exactly like a first boot and would silently re-stamp
+     * the declared name over the operator's rename. D49: that branch needs a
+     * second read to agree.
+     */
+    private applyDeclaration;
+    /**
+     * Remove rows under the addon's FIXED integration whose declaration is gone.
+     *
+     * Bounded to that integration: a declared integration has no operator
+     * add-flow, so every row under it got there by declaration. Devices this
+     * addon owns OUTSIDE it (a provider's adopted devices) are never candidates.
+     *
+     * Bounded in count, and every deletion is logged with its `deviceId` — a
+     * withdrawal that removes an operator-visible row silently is the failure
+     * mode, not the removal itself.
+     */
+    private sweepWithdrawn;
+}

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

@@ -6,19 +6,25 @@
  */
 export interface DeviceBindingEntry {
     capName: string;
-    /** `native`/`wrapped` = a real provider serves the cap. `linked` = the cap
-     *  is SYNTHESIZED from device-links (no provider — the getStatus dispatcher
-     *  routes to device-manager's resolveLinkedStatus). UI metadata only —
-     *  consumers must never branch on it for routing (D13). */
-    kind: 'native' | 'wrapped' | 'linked';
+    /**
+     * Which shape of provider serves the cap. UI metadata only — consumers must
+     * never branch on it for routing (D13); resolve a `(cap, device)` pair
+     * through `getProviderForDevice`.
+     *
+     * There were three. `linked` denoted a cap SYNTHESIZED from device-links with
+     * no provider at all, and it existed so a link-only cap would still render a
+     * panel — a fifth binding kind and a virtual-binding path the kernel paid for
+     * one feature. Wiring was deleted on 2026-08-08 (0 links across 302 devices)
+     * and the kind went with it: a composed device's caps are native to it, so
+     * nothing needs to be synthesized out of nowhere.
+     */
+    kind: 'native' | 'wrapped';
     /** Currently-active provider. For kind='native', equal to `nativeAddonId`.
-     *  For kind='wrapped', the wrapper addon id. For kind='linked', the
-     *  device-manager addon id (the synthesize owner). */
+     *  For kind='wrapped', the wrapper addon id. */
     providerAddonId: string;
     /** Node where the active provider runs. 'hub' for native; may vary for wrappers. */
     providerNodeId: string;
-    /** Always the addon id of the underlying native provider for the device.
-     *  Empty for kind='linked' (no native exists). */
+    /** Always the addon id of the underlying native provider for the device. */
     nativeAddonId: string;
 }
 export interface DeviceBinding {