@camstack/types 1.2.451 → 1.2.453

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

@@ -65,6 +65,8 @@ export type DiscoveredChildDevice = {
     features?: readonly string[];
     sourceInfo?: SourceInfo;
     children?: readonly DiscoveredChildDevice[];
+    /** `childNativeId` of the gateway candidate (in the same list) this device sits behind. */
+    parentStableId?: string;
 };
 export declare const DiscoveredChildDeviceSchema: z.ZodType<DiscoveredChildDevice>;
 /**

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

@@ -1763,6 +1763,9 @@ export declare const deviceManagerCapability: {
             alreadyOnboarded: z.ZodOptional<z.ZodBoolean>;
             onboardedDeviceId: z.ZodOptional<z.ZodNumber>;
             onboardedName: z.ZodOptional<z.ZodString>;
+            setupIntegration: z.ZodOptional<z.ZodBoolean>;
+            parentStableId: z.ZodOptional<z.ZodString>;
+            selectable: z.ZodOptional<z.ZodBoolean>;
         }, z.core.$strip>>, "mutation">;
         /** Adopt a discovered device via the device-provider capability. */
         readonly adoptDevice: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
@@ -1787,6 +1790,9 @@ export declare const deviceManagerCapability: {
                 alreadyOnboarded: z.ZodOptional<z.ZodBoolean>;
                 onboardedDeviceId: z.ZodOptional<z.ZodNumber>;
                 onboardedName: z.ZodOptional<z.ZodString>;
+                setupIntegration: z.ZodOptional<z.ZodBoolean>;
+                parentStableId: z.ZodOptional<z.ZodString>;
+                selectable: z.ZodOptional<z.ZodBoolean>;
             }, z.core.$strip>;
             integrationId: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>, z.ZodObject<{
@@ -2026,7 +2032,9 @@ export declare const deviceManagerCapability: {
             }, z.core.$strip>>>;
         }, z.core.$strip>, import("./capability-definition.js").CapabilityMethodKind>;
         /** Scan EVERY discovery-capable provider; returns candidates grouped by addon. */
-        readonly discoverAllProviders: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{}, z.core.$strip>, z.ZodObject<{
+        readonly discoverAllProviders: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
+            subnets: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        }, z.core.$strip>, z.ZodObject<{
             groups: z.ZodReadonly<z.ZodArray<z.ZodObject<{
                 addonId: z.ZodString;
                 label: z.ZodString;
@@ -2050,6 +2058,9 @@ export declare const deviceManagerCapability: {
                     alreadyOnboarded: z.ZodOptional<z.ZodBoolean>;
                     onboardedDeviceId: z.ZodOptional<z.ZodNumber>;
                     onboardedName: z.ZodOptional<z.ZodString>;
+                    setupIntegration: z.ZodOptional<z.ZodBoolean>;
+                    parentStableId: z.ZodOptional<z.ZodString>;
+                    selectable: z.ZodOptional<z.ZodBoolean>;
                 }, z.core.$strip>>>;
                 error: z.ZodNullable<z.ZodString>;
             }, z.core.$strip>>>;
@@ -2059,6 +2070,7 @@ export declare const deviceManagerCapability: {
         readonly discoverProvider: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
             addonId: z.ZodString;
             params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            subnets: z.ZodOptional<z.ZodArray<z.ZodString>>;
         }, z.core.$strip>, z.ZodObject<{
             candidates: z.ZodReadonly<z.ZodArray<z.ZodObject<{
                 stableId: z.ZodString;
@@ -2080,6 +2092,9 @@ export declare const deviceManagerCapability: {
                 alreadyOnboarded: z.ZodOptional<z.ZodBoolean>;
                 onboardedDeviceId: z.ZodOptional<z.ZodNumber>;
                 onboardedName: z.ZodOptional<z.ZodString>;
+                setupIntegration: z.ZodOptional<z.ZodBoolean>;
+                parentStableId: z.ZodOptional<z.ZodString>;
+                selectable: z.ZodOptional<z.ZodBoolean>;
             }, z.core.$strip>>>;
         }, z.core.$strip>, "mutation">;
         /** The device type a provider creates via manual add (Camera/Container/Hub),

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

@@ -13,6 +13,71 @@ declare const DiscoveredDeviceSchema: z.ZodObject<{
     type: z.ZodString;
     metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
 }, z.core.$strip>;
+/**
+ * HOW a provider can be found on the network. The provider only DECLARES the
+ * mode; the `local-network` scan engine runs it once for every provider that
+ * asked (one multicast browse, one host sweep) and hands the raw hits back to
+ * `classifyDiscoveryHits`. A provider never opens a discovery socket itself,
+ * except through a `custom` mode.
+ */
+export declare const DiscoveryModeSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    kind: z.ZodLiteral<"mdns">;
+    serviceType: z.ZodString;
+    instancePattern: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"ws-discovery">;
+    types: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"ssdp">;
+    searchTarget: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"udp-broadcast">;
+    port: z.ZodNumber;
+    payloadHex: z.ZodString;
+    listenPort: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"http-probe">;
+    port: z.ZodNumber;
+    path: z.ZodString;
+    method: z.ZodDefault<z.ZodEnum<{
+        GET: "GET";
+        POST: "POST";
+    }>>;
+    bodyText: z.ZodOptional<z.ZodString>;
+    contentType: z.ZodOptional<z.ZodString>;
+    tls: z.ZodDefault<z.ZodBoolean>;
+    acceptStatus: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"custom">;
+    reason: z.ZodString;
+}, z.core.$strip>], "kind">;
+export type DiscoveryMode = z.infer<typeof DiscoveryModeSchema>;
+/** What the engine saw on the wire for ONE declared mode; the provider classifies it. */
+export declare const DiscoveryHitSchema: z.ZodObject<{
+    modeIndex: z.ZodNumber;
+    host: z.ZodString;
+    port: z.ZodNumber;
+    http: z.ZodOptional<z.ZodObject<{
+        status: z.ZodNumber;
+        headers: z.ZodRecord<z.ZodString, z.ZodString>;
+        bodyText: z.ZodString;
+    }, z.core.$strip>>;
+    mdns: z.ZodOptional<z.ZodObject<{
+        instance: z.ZodString;
+        host: z.ZodString;
+        port: z.ZodNumber;
+        txt: z.ZodRecord<z.ZodString, z.ZodString>;
+    }, z.core.$strip>>;
+    udp: z.ZodOptional<z.ZodObject<{
+        payloadHex: z.ZodString;
+    }, z.core.$strip>>;
+    wsd: z.ZodOptional<z.ZodObject<{
+        xaddrs: z.ZodArray<z.ZodString>;
+        types: z.ZodArray<z.ZodString>;
+        scopes: z.ZodArray<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type DiscoveryHit = z.infer<typeof DiscoveryHitSchema>;
 /**
  * Candidate handed back from discovery and accepted by
  * `adoptDiscoveredDevice`. Shape mirrors the in-process
@@ -38,6 +103,9 @@ declare const DiscoveryCandidateSchema: z.ZodObject<{
     alreadyOnboarded: z.ZodOptional<z.ZodBoolean>;
     onboardedDeviceId: z.ZodOptional<z.ZodNumber>;
     onboardedName: z.ZodOptional<z.ZodString>;
+    setupIntegration: z.ZodOptional<z.ZodBoolean>;
+    parentStableId: z.ZodOptional<z.ZodString>;
+    selectable: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$strip>;
 /**
  * Flat device summary returned by `createDevice` / `adoptDiscoveredDevice`.
@@ -158,6 +226,100 @@ export declare const deviceProviderCapability: {
             alreadyOnboarded: z.ZodOptional<z.ZodBoolean>;
             onboardedDeviceId: z.ZodOptional<z.ZodNumber>;
             onboardedName: z.ZodOptional<z.ZodString>;
+            setupIntegration: z.ZodOptional<z.ZodBoolean>;
+            parentStableId: z.ZodOptional<z.ZodString>;
+            selectable: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strip>>, "mutation">;
+        /**
+         * How this provider is found on the network. `[]` = the provider has no
+         * declarative mode and keeps answering `discoverDevices` itself.
+         */
+        readonly getDiscoveryModes: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{}, z.core.$strip>, z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            kind: z.ZodLiteral<"mdns">;
+            serviceType: z.ZodString;
+            instancePattern: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>, z.ZodObject<{
+            kind: z.ZodLiteral<"ws-discovery">;
+            types: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        }, z.core.$strip>, z.ZodObject<{
+            kind: z.ZodLiteral<"ssdp">;
+            searchTarget: z.ZodString;
+        }, z.core.$strip>, z.ZodObject<{
+            kind: z.ZodLiteral<"udp-broadcast">;
+            port: z.ZodNumber;
+            payloadHex: z.ZodString;
+            listenPort: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>, z.ZodObject<{
+            kind: z.ZodLiteral<"http-probe">;
+            port: z.ZodNumber;
+            path: z.ZodString;
+            method: z.ZodDefault<z.ZodEnum<{
+                GET: "GET";
+                POST: "POST";
+            }>>;
+            bodyText: z.ZodOptional<z.ZodString>;
+            contentType: z.ZodOptional<z.ZodString>;
+            tls: z.ZodDefault<z.ZodBoolean>;
+            acceptStatus: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
+        }, z.core.$strip>, z.ZodObject<{
+            kind: z.ZodLiteral<"custom">;
+            reason: z.ZodString;
+        }, z.core.$strip>], "kind">>, import("./capability-definition.js").CapabilityMethodKind>;
+        /**
+         * Turn the engine's raw hits into candidates. The provider may make
+         * follow-up UNICAST requests to a hit host (an authenticated call, an
+         * identity check) and never sweeps a subnet. `params` is the per-scan form
+         * from `getDiscoveryParamsSchema`.
+         */
+        readonly classifyDiscoveryHits: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
+            hits: z.ZodArray<z.ZodObject<{
+                modeIndex: z.ZodNumber;
+                host: z.ZodString;
+                port: z.ZodNumber;
+                http: z.ZodOptional<z.ZodObject<{
+                    status: z.ZodNumber;
+                    headers: z.ZodRecord<z.ZodString, z.ZodString>;
+                    bodyText: z.ZodString;
+                }, z.core.$strip>>;
+                mdns: z.ZodOptional<z.ZodObject<{
+                    instance: z.ZodString;
+                    host: z.ZodString;
+                    port: z.ZodNumber;
+                    txt: z.ZodRecord<z.ZodString, z.ZodString>;
+                }, z.core.$strip>>;
+                udp: z.ZodOptional<z.ZodObject<{
+                    payloadHex: z.ZodString;
+                }, z.core.$strip>>;
+                wsd: z.ZodOptional<z.ZodObject<{
+                    xaddrs: z.ZodArray<z.ZodString>;
+                    types: z.ZodArray<z.ZodString>;
+                    scopes: z.ZodArray<z.ZodString>;
+                }, z.core.$strip>>;
+            }, z.core.$strip>>;
+            params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        }, z.core.$strip>, z.ZodArray<z.ZodObject<{
+            stableId: z.ZodString;
+            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>;
+                quantity: z.ZodOptional<z.ZodType<"angle" | "apparent-power" | "area" | "bitrate" | "colour-temperature" | "concentration-mass" | "concentration-ppb" | "concentration-volume" | "count" | "current" | "device" | "duration" | "duration-ms" | "energy" | "humidity" | "illuminance" | "index" | "information" | "irradiance" | "length" | "mass" | "none" | "percentage" | "power" | "precipitation" | "precipitation-rate" | "pressure" | "rate" | "ratio" | "signal-level" | "sound-level" | "speed" | "temperature" | "voltage" | "volume", unknown, z.core.$ZodTypeInternals<"angle" | "apparent-power" | "area" | "bitrate" | "colour-temperature" | "concentration-mass" | "concentration-ppb" | "concentration-volume" | "count" | "current" | "device" | "duration" | "duration-ms" | "energy" | "humidity" | "illuminance" | "index" | "information" | "irradiance" | "length" | "mass" | "none" | "percentage" | "power" | "precipitation" | "precipitation-rate" | "pressure" | "rate" | "ratio" | "signal-level" | "sound-level" | "speed" | "temperature" | "voltage" | "volume", unknown>>>;
+                dateTimeShape: z.ZodOptional<z.ZodEnum<{
+                    date: "date";
+                    datetime: "datetime";
+                    time: "time";
+                }>>;
+                raw: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            }, z.core.$strip>>;
+            alreadyOnboarded: z.ZodOptional<z.ZodBoolean>;
+            onboardedDeviceId: z.ZodOptional<z.ZodNumber>;
+            onboardedName: z.ZodOptional<z.ZodString>;
+            setupIntegration: z.ZodOptional<z.ZodBoolean>;
+            parentStableId: z.ZodOptional<z.ZodString>;
+            selectable: z.ZodOptional<z.ZodBoolean>;
         }, z.core.$strip>>, "mutation">;
         /**
          * Optional form schema (`ConfigUISchema`) for the EXTRA per-scan inputs a
@@ -196,6 +358,9 @@ export declare const deviceProviderCapability: {
                 alreadyOnboarded: z.ZodOptional<z.ZodBoolean>;
                 onboardedDeviceId: z.ZodOptional<z.ZodNumber>;
                 onboardedName: z.ZodOptional<z.ZodString>;
+                setupIntegration: z.ZodOptional<z.ZodBoolean>;
+                parentStableId: z.ZodOptional<z.ZodString>;
+                selectable: z.ZodOptional<z.ZodBoolean>;
             }, z.core.$strip>;
         }, z.core.$strip>, z.ZodObject<{
             id: z.ZodNumber;

package/dist/capabilities/index.d.ts

@@ -46,7 +46,7 @@ export { CustomModelDescriptorSchema, customModelRegistryCapability, ImportModel
 export { type DataStoreEngineInfo, dataStoreProviderCapability, EngineInfoSchema as DataStoreEngineInfoSchema, type IDataStoreProvider, } from './data-store-provider.cap.js';
 export { type ArchiveSqliteSnapshot, ArchiveSqliteSnapshotSchema, DATABASE_SNAPSHOT_PARTIAL_SUFFIX, DATABASE_SNAPSHOT_SUFFIX, DATABASE_SNAPSHOT_TIMEOUT_MS, type DatabaseSnapshotRequest, DatabaseSnapshotRequestSchema, type DatabaseSnapshotResult, DatabaseSnapshotResultSchema, type DatabaseSnapshotTable, DatabaseSnapshotTableSchema, type DatabaseSnapshotTargets, DatabaseSnapshotTargetsSchema, type DatabaseSnapshotWritten, DatabaseSnapshotWrittenSchema, databaseSnapshotCapability, type IDatabaseSnapshotProvider, } from './database-snapshot.cap.js';
 export { CALLER_STAMPED_CAPABILITIES, withoutCallerStamp } from './caller-stamp.js';
-export { type IStorageAdminProvider, type StorageKind, StorageKindSchema, type StorageTable, StorageTableSchema, storageAdminCapability, } from './storage-admin.cap.js';
+export { type IStorageAdminProvider, type StaleDataReport, StaleDataReportSchema, type StaleKindFinding, StaleKindFindingSchema, type StaleSettingsKeyFinding, StaleSettingsKeyFindingSchema, type StorageKind, StorageKindSchema, type StorageTable, StorageTableSchema, storageAdminCapability, } from './storage-admin.cap.js';
 export { type DeclareKindResult, DeclareKindResultSchema, type IRecordsProvider, type RecordInput, RecordInputSchema, type RecordQueryInput, RecordQueryInputSchema, type RecordQueryResult, RecordQueryResultSchema, type RecordView, RecordViewSchema, type RecordWhere, RecordWhereSchema, type RecordWhereValue, RecordIdSchema, RecordBodySchema, RecordSecretRefsSchema, type RecordTransactOp, RecordTransactOpSchema, recordsCapability, } from './records.cap.js';
 export { type EntryKindInfo, EntryKindInfoSchema, type EntryView, EntryViewSchema, type IRecordEntriesProvider, recordEntriesCapability, } from './record-entries.cap.js';
 export { type IKeychainProvider, KEYCHAIN_MAX_REFS_PER_CALL, type KeychainResolveEntry, KeychainResolveEntrySchema, type KeychainResolveResult, KeychainResolveResultSchema, type KeychainSecretMeta, KeychainSecretMetaSchema, type KeychainState, KeychainStateSchema, type KeychainUnavailableReason, KeychainUnavailableReasonSchema, keychainCapability, } from './keychain.cap.js';
@@ -66,7 +66,7 @@ export type { ExtensionCandidate, ExtensionCandidates, ExtensionSetResult, Exten
 export { deviceExtensionCapability, EXTENSION_SLOT_LISTING_METHOD, EXTENSION_SLOT_REF_SEPARATOR, ExtensionCandidateSchema, ExtensionCandidatesSchema, ExtensionSetResultSchema, ExtensionSetSlotInputSchema, ExtensionSlotActivationSchema, ExtensionSlotRefInputSchema, ExtensionSlotRowSchema, ExtensionSlotSourceSchema, ExtensionSlotStateSchema, ExtensionSlotUnreachableSchema, ExtensionSourceAvailabilitySchema, ExtensionSourceHealthSchema, ExtensionSourceSchema, unreachableExtensionSlotRow, } from './device-extension.cap.js';
 export type { CleanupDeletedDevicesResult, DeviceInfo, DeviceManagerApplyInitialMetaInput, DeviceTombstone, OrphanDeviceData, } from './device-manager.cap.js';
 export { CleanupDeletedDevicesResultSchema, ConfigEntrySchema, DEVICE_CHILDREN_BATCH_MAX, DEVICE_TOMBSTONE_RETENTION_MS, DeviceInfoSchema, DeviceTombstoneSchema, OrphanDeviceDataSchema, deviceManagerCapability, type IDeviceManagerProvider, LINKED_DEVICES_SLOT, type LinkedDevice, LinkedDeviceSchema, type LinkedDevicesMode, LinkedDevicesModeSchema, type LinkedDevicesSlotValue, LinkedDevicesSlotValueSchema, type MigrateDeviceResult, MigrateDeviceResultSchema, type MigrateSwitchOutcome, MigrateSwitchOutcomeSchema, type MigrateSwitchReport, MigrateSwitchReportSchema, type WrapperActivationRead, WrapperActivationReadSchema, } from './device-manager.cap.js';
-export { DiscoveredDeviceSchema, deviceProviderCapability, ProviderStatusSchema, } from './device-provider.cap.js';
+export { DiscoveredDeviceSchema, type DiscoveryHit, DiscoveryHitSchema, type DiscoveryMode, DiscoveryModeSchema, deviceProviderCapability, ProviderStatusSchema, } from './device-provider.cap.js';
 export { type ClaimOutcome, ClaimOutcomeSchema, type ClaimsListing, ClaimsListingSchema, deviceStateCapability, type FieldClaim, type FieldClaimMode, FieldClaimModeSchema, FieldClaimSchema, } from './device-state.cap.js';
 export type { EmbeddingFailedModel, EmbeddingFailedRequirement, EmbeddingModelFailure, EmbeddingRefusal, EmbeddingRefusalCode, EmbeddingTower, IEmbeddingEncoderProvider, } from './embedding-encoder.cap.js';
 export { EMBEDDING_MODEL_FAILED, EMBEDDING_REQUIREMENTS_FAILED, EMBEDDING_REQUIREMENTS_UNAVAILABLE, EmbeddingFailedModelSchema, EmbeddingFailedRequirementSchema, EmbeddingInfoSchema, EmbeddingRefusalCodeSchema, EmbeddingResultSchema, EmbeddingTowerSchema, embeddingEncoderCapability, embeddingModelFailedError, embeddingModelFailedOf, embeddingRefusalOf, embeddingRequirementsFailedError, embeddingRequirementsUnavailableError, isEmbeddingModelFailed, } from './embedding-encoder.cap.js';
@@ -204,7 +204,7 @@ export { type BacklightMode, BacklightModeSchema, type ExposureMode, ExposureMod
 export { AvailableIntegrationTypeSchema, CreateIntegrationInputSchema, DeleteIntegrationResultSchema, type IIntegrationsProvider, IntegrationLiteSchema, type IntegrationTestConnectionResult, type IntegrationTestConnectionStatus, IntegrationWithStateSchema, integrationsCapability, TestConnectionResultSchema, TestConnectionStatusEnum, UpdateIntegrationInputSchema, } from './integrations.cap.js';
 export { type IIntercomProvider, type IntercomAbility, IntercomAbilitySchema, type IntercomStatus, IntercomStatusSchema, intercomCapability, } from './intercom.cap.js';
 export { type DeviceCodeSeverity, DeviceCodeSeveritySchema, type ILawnMowerControlProvider, type LawnMowerActivity, LawnMowerActivitySchema, type LawnMowerControlStatus, LawnMowerControlStatusSchema, lawnMowerControlCapability, } from './lawn-mower-control.cap.js';
-export { type AdvertisedLocalPort, type ConnectionEndpoint, type HubAddressBook, type HubAddresses, HubAddressRoleSchema, type HubAddressRow, type HubAddressSnapshot, type ILocalNetworkProvider, type LocalInterface, localNetworkCapability, type NotificationEndpoint, } from './local-network.cap.js';
+export { type AdvertisedLocalPort, type ConnectionEndpoint, type HubAddressBook, type HubAddresses, HubAddressRoleSchema, type HubAddressRow, type HubAddressSnapshot, type ILocalNetworkProvider, type LocalInterface, localNetworkCapability, type NotificationEndpoint, type ScanNetworkResult, type ScanRequest, type ScanStats, } from './local-network.cap.js';
 export { type ILockControlProvider, type LockControlStatus, LockControlStatusSchema, type LockState, LockStateSchema, lockControlCapability, } from './lock-control.cap.js';
 export { type MaskGridDims, MaskGridDimsSchema, type MaskGridShape, MaskGridShapeSchema, type MaskLineShape, MaskLineShapeSchema, type MaskPoint, MaskPointSchema, type MaskPolygonShape, MaskPolygonShapeSchema, type MaskPolygonVertices, MaskPolygonVerticesSchema, type MaskRectShape, MaskRectShapeSchema, type MaskShape, type MaskShapeKind, MaskShapeKindSchema, MaskShapeSchema, } from './mask-shape.js';
 export { type MeterStatus, MeterStatusSchema, meterCapability, type IMeterProvider, } from './meter.cap.js';

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

@@ -200,6 +200,7 @@ export declare const integrationsCapability: {
             id: z.ZodString;
             settings: z.ZodRecord<z.ZodString, z.ZodUnknown>;
             secretKeys: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            skipRestart: z.ZodOptional<z.ZodBoolean>;
         }, z.core.$strip>, z.ZodObject<{
             success: z.ZodBoolean;
         }, z.core.$strip>, "mutation">;

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

@@ -160,6 +160,18 @@ export declare const keychainCapability: {
         }, z.core.$strip>, z.ZodObject<{
             refs: z.ZodReadonly<z.ZodArray<z.ZodString>>;
         }, z.core.$strip>, "mutation">;
+        /**
+         * Release the values rows of a DROPPED record kind held, whatever the kind's
+         * owner (stale-data audit). Reserved to `sqlite-settings`, the engine that
+         * just deleted the rows: only refs scoped `row/records:<kind>/...` are
+         * accepted, and the audit names the operator it acted for. Answers a count.
+         */
+        readonly releaseRecordRefs: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
+            refs: z.ZodArray<z.ZodString>;
+            onBehalfOf: z.ZodString;
+        }, z.core.$strip>, z.ZodObject<{
+            released: z.ZodNumber;
+        }, z.core.$strip>, "mutation">;
         /** The caller's own refs, metadata only. */
         readonly listMeta: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{}, z.core.$strip>, z.ZodReadonly<z.ZodArray<z.ZodObject<{
             ref: z.ZodString;

package/dist/capabilities/local-network.cap.d.ts

@@ -295,6 +295,97 @@ declare const HubAddressBookSchema: z.ZodObject<{
     listenerOrigins: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodString>>>;
 }, z.core.$strip>;
 export type HubAddressBook = z.infer<typeof HubAddressBookSchema>;
+/** One provider's ask of the scan engine: the modes it declared. */
+declare const ScanRequestSchema: z.ZodObject<{
+    providerId: z.ZodString;
+    modes: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"mdns">;
+        serviceType: z.ZodString;
+        instancePattern: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"ws-discovery">;
+        types: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"ssdp">;
+        searchTarget: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"udp-broadcast">;
+        port: z.ZodNumber;
+        payloadHex: z.ZodString;
+        listenPort: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"http-probe">;
+        port: z.ZodNumber;
+        path: z.ZodString;
+        method: z.ZodDefault<z.ZodEnum<{
+            GET: "GET";
+            POST: "POST";
+        }>>;
+        bodyText: z.ZodOptional<z.ZodString>;
+        contentType: z.ZodOptional<z.ZodString>;
+        tls: z.ZodDefault<z.ZodBoolean>;
+        acceptStatus: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"custom">;
+        reason: z.ZodString;
+    }, z.core.$strip>], "kind">>;
+}, z.core.$strip>;
+/** What one scan did, per mode family; the engine logs the same numbers once. */
+declare const ScanStatsSchema: z.ZodObject<{
+    hostsProbed: z.ZodNumber;
+    hits: z.ZodNumber;
+    timeouts: z.ZodNumber;
+    byMode: z.ZodRecord<z.ZodString, z.ZodObject<{
+        probed: z.ZodNumber;
+        hits: z.ZodNumber;
+        timeouts: z.ZodNumber;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+declare const ScanNetworkResultSchema: z.ZodObject<{
+    hits: z.ZodArray<z.ZodObject<{
+        providerId: z.ZodString;
+        hit: z.ZodObject<{
+            modeIndex: z.ZodNumber;
+            host: z.ZodString;
+            port: z.ZodNumber;
+            http: z.ZodOptional<z.ZodObject<{
+                status: z.ZodNumber;
+                headers: z.ZodRecord<z.ZodString, z.ZodString>;
+                bodyText: z.ZodString;
+            }, z.core.$strip>>;
+            mdns: z.ZodOptional<z.ZodObject<{
+                instance: z.ZodString;
+                host: z.ZodString;
+                port: z.ZodNumber;
+                txt: z.ZodRecord<z.ZodString, z.ZodString>;
+            }, z.core.$strip>>;
+            udp: z.ZodOptional<z.ZodObject<{
+                payloadHex: z.ZodString;
+            }, z.core.$strip>>;
+            wsd: z.ZodOptional<z.ZodObject<{
+                xaddrs: z.ZodArray<z.ZodString>;
+                types: z.ZodArray<z.ZodString>;
+                scopes: z.ZodArray<z.ZodString>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>;
+    }, z.core.$strip>>;
+    subnetsScanned: z.ZodArray<z.ZodString>;
+    errors: z.ZodArray<z.ZodObject<{
+        providerId: z.ZodOptional<z.ZodString>;
+        mode: z.ZodOptional<z.ZodString>;
+        message: z.ZodString;
+    }, z.core.$strip>>;
+    stats: z.ZodObject<{
+        hostsProbed: z.ZodNumber;
+        hits: z.ZodNumber;
+        timeouts: z.ZodNumber;
+        byMode: z.ZodRecord<z.ZodString, z.ZodObject<{
+            probed: z.ZodNumber;
+            hits: z.ZodNumber;
+            timeouts: z.ZodNumber;
+        }, z.core.$strip>>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
 export declare const localNetworkCapability: {
     readonly name: 'local-network';
     readonly scope: 'system';
@@ -1046,6 +1137,110 @@ export declare const localNetworkCapability: {
                 hasCa: z.ZodBoolean;
             }, z.core.$strip>>;
         }, z.core.$strip>, "mutation">;
+        /**
+         * The LAN discovery engine. Every provider that declared discovery modes
+         * (`device-provider.getDiscoveryModes`) is scanned in ONE pass: a single
+         * mDNS browse for the union of service types, one WS-Discovery probe, one
+         * SSDP search per target and one sweep that visits each host once and runs
+         * every http-probe of every provider. Subnets scanned = the hub's own
+         * non-internal IPv4 /24s ∪ the saved list (`getScanSubnets`) ∪ `subnets`.
+         * A bad CIDR, or more than 4096 hosts in total, refuses the scan.
+         */
+        readonly scanNetwork: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
+            requests: z.ZodArray<z.ZodObject<{
+                providerId: z.ZodString;
+                modes: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+                    kind: z.ZodLiteral<"mdns">;
+                    serviceType: z.ZodString;
+                    instancePattern: z.ZodOptional<z.ZodString>;
+                }, z.core.$strip>, z.ZodObject<{
+                    kind: z.ZodLiteral<"ws-discovery">;
+                    types: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                }, z.core.$strip>, z.ZodObject<{
+                    kind: z.ZodLiteral<"ssdp">;
+                    searchTarget: z.ZodString;
+                }, z.core.$strip>, z.ZodObject<{
+                    kind: z.ZodLiteral<"udp-broadcast">;
+                    port: z.ZodNumber;
+                    payloadHex: z.ZodString;
+                    listenPort: z.ZodOptional<z.ZodNumber>;
+                }, z.core.$strip>, z.ZodObject<{
+                    kind: z.ZodLiteral<"http-probe">;
+                    port: z.ZodNumber;
+                    path: z.ZodString;
+                    method: z.ZodDefault<z.ZodEnum<{
+                        GET: "GET";
+                        POST: "POST";
+                    }>>;
+                    bodyText: z.ZodOptional<z.ZodString>;
+                    contentType: z.ZodOptional<z.ZodString>;
+                    tls: z.ZodDefault<z.ZodBoolean>;
+                    acceptStatus: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
+                }, z.core.$strip>, z.ZodObject<{
+                    kind: z.ZodLiteral<"custom">;
+                    reason: z.ZodString;
+                }, z.core.$strip>], "kind">>;
+            }, z.core.$strip>>;
+            subnets: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        }, z.core.$strip>, z.ZodObject<{
+            hits: z.ZodArray<z.ZodObject<{
+                providerId: z.ZodString;
+                hit: z.ZodObject<{
+                    modeIndex: z.ZodNumber;
+                    host: z.ZodString;
+                    port: z.ZodNumber;
+                    http: z.ZodOptional<z.ZodObject<{
+                        status: z.ZodNumber;
+                        headers: z.ZodRecord<z.ZodString, z.ZodString>;
+                        bodyText: z.ZodString;
+                    }, z.core.$strip>>;
+                    mdns: z.ZodOptional<z.ZodObject<{
+                        instance: z.ZodString;
+                        host: z.ZodString;
+                        port: z.ZodNumber;
+                        txt: z.ZodRecord<z.ZodString, z.ZodString>;
+                    }, z.core.$strip>>;
+                    udp: z.ZodOptional<z.ZodObject<{
+                        payloadHex: z.ZodString;
+                    }, z.core.$strip>>;
+                    wsd: z.ZodOptional<z.ZodObject<{
+                        xaddrs: z.ZodArray<z.ZodString>;
+                        types: z.ZodArray<z.ZodString>;
+                        scopes: z.ZodArray<z.ZodString>;
+                    }, z.core.$strip>>;
+                }, z.core.$strip>;
+            }, z.core.$strip>>;
+            subnetsScanned: z.ZodArray<z.ZodString>;
+            errors: z.ZodArray<z.ZodObject<{
+                providerId: z.ZodOptional<z.ZodString>;
+                mode: z.ZodOptional<z.ZodString>;
+                message: z.ZodString;
+            }, z.core.$strip>>;
+            stats: z.ZodObject<{
+                hostsProbed: z.ZodNumber;
+                hits: z.ZodNumber;
+                timeouts: z.ZodNumber;
+                byMode: z.ZodRecord<z.ZodString, z.ZodObject<{
+                    probed: z.ZodNumber;
+                    hits: z.ZodNumber;
+                    timeouts: z.ZodNumber;
+                }, z.core.$strip>>;
+            }, z.core.$strip>;
+        }, z.core.$strip>, "mutation">;
+        /** Extra subnets every scan covers besides the hub's own, as CIDR strings. */
+        readonly getScanSubnets: import("./capability-definition.js").CapabilityMethodSchema<z.ZodVoid, z.ZodObject<{
+            subnets: z.ZodArray<z.ZodString>;
+        }, z.core.$strip>, import("./capability-definition.js").CapabilityMethodKind>;
+        /**
+         * Replace the saved extra subnets (a cluster setting). Each entry is IPv4
+         * CIDR, at most a /22; the list is refused when it is invalid or its hosts
+         * would exceed the scan cap.
+         */
+        readonly setScanSubnets: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
+            subnets: z.ZodArray<z.ZodString>;
+        }, z.core.$strip>, z.ZodObject<{
+            subnets: z.ZodArray<z.ZodString>;
+        }, z.core.$strip>, "mutation">;
         /** Return to the generated local CA. The uploaded certificate stays stored (D873). */
         readonly revertToGeneratedCertificate: import("./capability-definition.js").CapabilityMethodSchema<z.ZodVoid, z.ZodObject<{
             mode: z.ZodEnum<{
@@ -1075,6 +1270,9 @@ export declare const localNetworkCapability: {
         readonly kind: 'hub-only';
     };
 };
+export type ScanNetworkResult = z.infer<typeof ScanNetworkResultSchema>;
+export type ScanRequest = z.infer<typeof ScanRequestSchema>;
+export type ScanStats = z.infer<typeof ScanStatsSchema>;
 export type ILocalNetworkProvider = InferProvider<typeof localNetworkCapability>;
 export type LocalInterface = z.infer<typeof LocalInterfaceSchema>;
 export type ConnectionEndpoint = z.infer<typeof ConnectionEndpointSchema>;