@camstack/types 1.1.10 → 1.1.12

package/dist/index.mjs

@@ -1,4 +1,4 @@
-import { $ as SubscribeAudioChunksResultSchema, A as ReadinessRegistry, B as CamStreamResolutionSchema, C as asJsonObject, D as parseJsonObject, E as parseJsonArray, F as BrokerStatsSchema, G as FrameHandleFormatSchema, H as DecodedAudioChunkSchema, I as BrokerStatusSchema, J as ProfileSlotSchema, K as FrameHandleSchema, L as CAM_PROFILE_ORDER, M as emitDownForOwnedCaps, N as readinessKey, O as parseJsonUnknown, P as scopeKey, Q as SubscribeAudioChunksInputSchema, R as CamProfileSchema, S as asJsonArray, T as asString, U as DecodedFrameSchema, V as CameraStreamSchema, W as EncodedPacketSchema, X as StreamSourceEntrySchema, Y as ProfileSlotStatusSchema, Z as StreamSourceSchema, _ as ChargingStatus, a as adminUiCapability, at as selectAssignedProfileSlots, b as DeviceType, c as createMirrorSource, ct as createDurableState, d as DEVICE_STATUS_METHOD, dt as isEvent, et as SubscribeFramesInputSchema, f as event, ft as WELL_KNOWN_TABS, g as resolveCapMount, gt as DisposerChain, h as method, ht as EventCategory, i as deviceOpsCapability, it as parseProfileBrokerId, j as ReadinessTimeoutError, k as DATAPLANE_SECRET_HEADER, l as createSliceHandle, lt as createEvent, m as isDeviceConfigCap, mt as hydrateSchema, n as sleepCancellable, nt as makeProfileBrokerId, o as createDeviceProxy, ot as BaseAddon, p as expandCapMethods, pt as WELL_KNOWN_TAB_MAP, q as ProfileRtspEntrySchema, r as RawStateResultSchema, rt as makeSourceBrokerId, s as createLazyTrpcSource, st as normalizeAddonInitResult, t as sleep, tt as SubscribeFramesResultSchema, u as DEVICE_SETTINGS_CONTRIBUTION_METHODS, ut as emitReadiness, v as DeviceFeature, w as asNumber, x as asBoolean, y as DeviceRole, z as CamStreamKindSchema } from "./sleep-B3AOslwX.mjs";
+import { $ as SubscribeAudioChunksResultSchema, A as ReadinessRegistry, B as CamStreamResolutionSchema, C as asJsonObject, D as parseJsonObject, E as parseJsonArray, F as BrokerStatsSchema, G as FrameHandleFormatSchema, H as DecodedAudioChunkSchema, I as BrokerStatusSchema, J as ProfileSlotSchema, K as FrameHandleSchema, L as CAM_PROFILE_ORDER, M as emitDownForOwnedCaps, N as readinessKey, O as parseJsonUnknown, P as scopeKey, Q as SubscribeAudioChunksInputSchema, R as CamProfileSchema, S as asJsonArray, T as asString, U as DecodedFrameSchema, V as CameraStreamSchema, W as EncodedPacketSchema, X as StreamSourceEntrySchema, Y as ProfileSlotStatusSchema, Z as StreamSourceSchema, _ as ChargingStatus, a as adminUiCapability, at as selectAssignedProfileSlots, b as DeviceType, c as createMirrorSource, ct as createDurableState, d as DEVICE_STATUS_METHOD, dt as isEvent, et as SubscribeFramesInputSchema, f as event, ft as WELL_KNOWN_TABS, g as resolveCapMount, gt as DisposerChain, h as method, ht as EventCategory, i as deviceOpsCapability, it as parseProfileBrokerId, j as ReadinessTimeoutError, k as DATAPLANE_SECRET_HEADER, l as createSliceHandle, lt as createEvent, m as isDeviceConfigCap, mt as hydrateSchema, n as sleepCancellable, nt as makeProfileBrokerId, o as createDeviceProxy, ot as BaseAddon, p as expandCapMethods, pt as WELL_KNOWN_TAB_MAP, q as ProfileRtspEntrySchema, r as RawStateResultSchema, rt as makeSourceBrokerId, s as createLazyTrpcSource, st as normalizeAddonInitResult, t as sleep, tt as SubscribeFramesResultSchema, u as DEVICE_SETTINGS_CONTRIBUTION_METHODS, ut as emitReadiness, v as DeviceFeature, w as asNumber, x as asBoolean, y as DeviceRole, z as CamStreamKindSchema } from "./sleep-C2M2zF7x.mjs";
 import { t as errMsg } from "./err-msg-IQTHeDzc.mjs";
 import { z } from "zod";
 //#region src/health/wiring-health.ts
@@ -4215,7 +4215,7 @@ var climateControlCapability = {
 	scope: "device",
 	deviceNative: true,
 	mode: "singleton",
-	deviceTypes: [DeviceType.Thermostat],
+	deviceTypes: [DeviceType.Thermostat, DeviceType.Climate],
 	methods: {
 		setMode: method(z.object({
 			deviceId: z.number().int().nonnegative(),
@@ -9426,10 +9426,30 @@ var deviceProviderCapability = {
 			type: z.string()
 		}))),
 		supportsDiscovery: method(z.object({}), z.boolean()),
-		discoverDevices: method(z.object({}), z.array(DiscoveryCandidateSchema), {
+		/**
+		* Run a network scan. `params` carries optional provider-specific scan
+		* inputs (e.g. a broadcast address / subnet for cross-subnet discovery),
+		* shaped by `getDiscoveryParamsSchema`. Omitted for the generic scan
+		* (provider uses its local-network default).
+		*/
+		discoverDevices: method(z.object({ params: z.record(z.string(), z.unknown()).optional() }), z.array(DiscoveryCandidateSchema), {
 			kind: "mutation",
 			auth: "admin"
 		}),
+		/**
+		* Optional form schema (`ConfigUISchema`) for the EXTRA per-scan inputs a
+		* provider accepts (e.g. Gree's broadcast address for a different subnet).
+		* `null` when the provider takes no extra scan params — the generic
+		* aggregated scan never renders this; the per-integration scan does.
+		*/
+		getDiscoveryParamsSchema: method(z.object({}), CreationSchemaOutputSchema),
+		/**
+		* The DeviceType this provider creates via manual add (Camera for
+		* Reolink/ONVIF, Container for Gree, Hub for Ecowitt). `null` when the
+		* provider does not support manual creation. Lets the Add-Device dialog
+		* pick the right type instead of assuming Camera.
+		*/
+		getManualCreationType: method(z.object({}), z.object({ deviceType: z.enum(DeviceType).nullable() })),
 		adoptDiscoveredDevice: method(z.object({ candidate: DiscoveryCandidateSchema }), DeviceSummarySchema, {
 			kind: "mutation",
 			auth: "admin"
@@ -9555,9 +9575,23 @@ var BaseDeviceProvider = class extends BaseAddon {
 	async supportsDiscovery() {
 		return false;
 	}
-	async discoverDevices() {
+	async discoverDevices(_input) {
 		return [];
 	}
+	/** Extra per-scan input form (e.g. a broadcast address for another subnet).
+	*  Null = no extra params. Override in providers that support scoped scans. */
+	async getDiscoveryParamsSchema() {
+		return null;
+	}
+	/**
+	* The DeviceType this provider creates via manual add — derived from the
+	* `deviceClasses` map (first registered type). `null` when manual creation is
+	* unsupported. Lets the Add-Device dialog pick the right type per provider.
+	*/
+	async getManualCreationType() {
+		if (!await this.supportsManualCreation()) return { deviceType: null };
+		return { deviceType: Object.values(DeviceType).find((t) => this.deviceClasses[t] !== void 0) ?? null };
+	}
 	async adoptDiscoveredDevice(_input) {
 		throw new Error(`${this.providerName} provider does not support discovery-based adoption`);
 	}
@@ -10168,11 +10202,17 @@ function createSystemProxy(api) {
 			getCreationSchema: (input) => dispatch("deviceManager", "getCreationSchema", "query", input),
 			createDevice: (input) => dispatch("deviceManager", "createDevice", "mutation", input),
 			testCreationField: (input) => dispatch("deviceManager", "testCreationField", "mutation", input),
+			adoptionListCandidateFilters: (input) => dispatch("deviceManager", "adoptionListCandidateFilters", "query", input),
 			adoptionListCandidates: (input) => dispatch("deviceManager", "adoptionListCandidates", "query", input),
 			adoptionRefresh: (input) => dispatch("deviceManager", "adoptionRefresh", "mutation", input),
 			adoptionAdopt: (input) => dispatch("deviceManager", "adoptionAdopt", "mutation", input),
 			adoptionRelease: (input) => dispatch("deviceManager", "adoptionRelease", "mutation", input),
-			adoptionResync: (input) => dispatch("deviceManager", "adoptionResync", "mutation", input)
+			adoptionResync: (input) => dispatch("deviceManager", "adoptionResync", "mutation", input),
+			discoveryProviders: (input) => dispatch("deviceManager", "discoveryProviders", "query", input),
+			discoverAllProviders: (input) => dispatch("deviceManager", "discoverAllProviders", "mutation", input),
+			discoverProvider: (input) => dispatch("deviceManager", "discoverProvider", "mutation", input),
+			providerCreationType: (input) => dispatch("deviceManager", "providerCreationType", "query", input),
+			providerDiscoveryParamsSchema: (input) => dispatch("deviceManager", "providerDiscoveryParamsSchema", "query", input)
 		},
 		deviceProvider: {
 			start: (input) => dispatch("deviceProvider", "start", "mutation", input),
@@ -10181,6 +10221,8 @@ function createSystemProxy(api) {
 			getDevices: (input) => dispatch("deviceProvider", "getDevices", "query", input),
 			supportsDiscovery: (input) => dispatch("deviceProvider", "supportsDiscovery", "query", input),
 			discoverDevices: (input) => dispatch("deviceProvider", "discoverDevices", "mutation", input),
+			getDiscoveryParamsSchema: (input) => dispatch("deviceProvider", "getDiscoveryParamsSchema", "query", input),
+			getManualCreationType: (input) => dispatch("deviceProvider", "getManualCreationType", "query", input),
 			adoptDiscoveredDevice: (input) => dispatch("deviceProvider", "adoptDiscoveredDevice", "mutation", input),
 			supportsManualCreation: (input) => dispatch("deviceProvider", "supportsManualCreation", "query", input),
 			getChildCreationSchema: (input) => dispatch("deviceProvider", "getChildCreationSchema", "query", input),
@@ -13650,6 +13692,12 @@ var deviceManagerCapability = {
 			kind: "mutation",
 			auth: "admin"
 		}),
+		/** List candidate filter chips for an integration via its device-adoption
+		*  provider — addonId-routed so it never hits the singleton shadow. */
+		adoptionListCandidateFilters: method(z.object({
+			addonId: z.string(),
+			integrationId: z.string()
+		}), z.object({ filters: z.array(AdoptionFilterSchema) }), { auth: "admin" }),
 		/** List adoption candidates for an integration via its device-adoption provider. */
 		adoptionListCandidates: method(ListCandidatesInputSchema.extend({ addonId: z.string() }), ListCandidatesOutputSchema, { auth: "admin" }),
 		/** Trigger a discovery refresh on the integration's device-adoption provider. */
@@ -13680,6 +13728,36 @@ var deviceManagerCapability = {
 			kind: "mutation",
 			auth: "admin"
 		}),
+		/** Addons whose device-provider reports `supportsDiscovery` (for the modal). */
+		discoveryProviders: method(z.object({}), z.object({ providers: z.array(z.object({
+			addonId: z.string(),
+			label: z.string()
+		})).readonly() }), { auth: "admin" }),
+		/** Scan EVERY discovery-capable provider; returns candidates grouped by addon. */
+		discoverAllProviders: method(z.object({}), z.object({ groups: z.array(z.object({
+			addonId: z.string(),
+			label: z.string(),
+			candidates: z.array(DiscoveryCandidateSchema).readonly(),
+			error: z.string().nullable()
+		})).readonly() }), {
+			kind: "mutation",
+			auth: "admin"
+		}),
+		/** Scan ONE provider with optional provider-specific params (subnet /
+		*  broadcast addr) — the per-integration "Scan network" surface. */
+		discoverProvider: method(z.object({
+			addonId: z.string(),
+			params: z.record(z.string(), z.unknown()).optional()
+		}), z.object({ candidates: z.array(DiscoveryCandidateSchema).readonly() }), {
+			kind: "mutation",
+			auth: "admin"
+		}),
+		/** The device type a provider creates via manual add (Camera/Container/Hub),
+		*  so the Add-Device dialog uses the right type instead of assuming Camera. */
+		providerCreationType: method(z.object({ addonId: z.string() }), z.object({ deviceType: z.enum(DeviceType).nullable() }), { auth: "admin" }),
+		/** A provider's extra per-scan param form (ConfigUISchema) for the
+		*  per-integration scan, or null when it takes none. */
+		providerDiscoveryParamsSchema: method(z.object({ addonId: z.string() }), z.unknown(), { auth: "admin" }),
 		/**
 		* Test a field value on an existing device (e.g. probe an RTSP URL).
 		* Routes through the device-provider for the owning addon.
@@ -17659,6 +17737,17 @@ var AvailableIntegrationTypeSchema = z.object({
 	iconUrl: z.string().nullable(),
 	color: z.string(),
 	instanceMode: z.string(),
+	/**
+	* Integration wizard `mode` (LOCKED MODEL): `standalone` (create
+	* immediately then add devices, no config step/button), `account` (config
+	* step), or `broker` (broker step). Derived server-side by
+	* `getAvailableTypes` when the addon manifest omits an explicit `mode`.
+	*/
+	mode: z.enum([
+		"standalone",
+		"account",
+		"broker"
+	]),
 	discoveryMode: z.string(),
 	/**
 	* Which integration-marker cap the addon declared, so the wizard can
@@ -21853,6 +21942,12 @@ var METHOD_ACCESS_MAP = Object.freeze({
 		addonId: null,
 		access: "create"
 	},
+	"deviceManager.adoptionListCandidateFilters": {
+		capName: "device-manager",
+		capScope: "system",
+		addonId: null,
+		access: "view"
+	},
 	"deviceManager.adoptionListCandidates": {
 		capName: "device-manager",
 		capScope: "system",
@@ -21901,12 +21996,30 @@ var METHOD_ACCESS_MAP = Object.freeze({
 		addonId: null,
 		access: "create"
 	},
+	"deviceManager.discoverAllProviders": {
+		capName: "device-manager",
+		capScope: "system",
+		addonId: null,
+		access: "create"
+	},
 	"deviceManager.discoverDevices": {
 		capName: "device-manager",
 		capScope: "system",
 		addonId: null,
 		access: "create"
 	},
+	"deviceManager.discoverProvider": {
+		capName: "device-manager",
+		capScope: "system",
+		addonId: null,
+		access: "create"
+	},
+	"deviceManager.discoveryProviders": {
+		capName: "device-manager",
+		capScope: "system",
+		addonId: null,
+		access: "view"
+	},
 	"deviceManager.enable": {
 		capName: "device-manager",
 		capScope: "system",
@@ -22057,6 +22170,18 @@ var METHOD_ACCESS_MAP = Object.freeze({
 		addonId: null,
 		access: "create"
 	},
+	"deviceManager.providerCreationType": {
+		capName: "device-manager",
+		capScope: "system",
+		addonId: null,
+		access: "view"
+	},
+	"deviceManager.providerDiscoveryParamsSchema": {
+		capName: "device-manager",
+		capScope: "system",
+		addonId: null,
+		access: "view"
+	},
 	"deviceManager.registerDevice": {
 		capName: "device-manager",
 		capScope: "system",
@@ -22273,6 +22398,18 @@ var METHOD_ACCESS_MAP = Object.freeze({
 		addonId: null,
 		access: "view"
 	},
+	"deviceProvider.getDiscoveryParamsSchema": {
+		capName: "device-provider",
+		capScope: "system",
+		addonId: null,
+		access: "view"
+	},
+	"deviceProvider.getManualCreationType": {
+		capName: "device-provider",
+		capScope: "system",
+		addonId: null,
+		access: "view"
+	},
 	"deviceProvider.getStatus": {
 		capName: "device-provider",
 		capScope: "system",

package/dist/interfaces/addon.d.ts

@@ -809,6 +809,22 @@ export interface AddonDeclaration {
     readonly slot?: PipelineSlot | null;
     /** Instance mode: 'unique' or 'multiple'. Default: 'multiple' */
     readonly instanceMode?: 'unique' | 'multiple';
+    /**
+     * Integration `mode` — how the Add-Integration wizard behaves for this
+     * addon (LOCKED MODEL, supersedes `instanceMode` for wizard routing):
+     *   - `'standalone'` — NO integration-level config; picking creates the
+     *     integration immediately (empty settings) and goes straight to
+     *     adding/discovering the first device. No config step, no config
+     *     button on the detail page. (Reolink/ONVIF/Ecowitt/Gree.)
+     *   - `'account'` — account/connection config; wizard shows the config
+     *     step, then `integrations.create` with those settings.
+     *     (Dreo/Wyze/Dreame.)
+     *   - `'broker'` — the shared-bus/session broker step. (HomeAssistant/MQTT.)
+     * Optional/transitional: when absent, `getAvailableTypes` DERIVES the mode
+     * (broker cap + brokerKind → broker; device-adoption → account; else →
+     * standalone). `instanceMode` is kept for now.
+     */
+    readonly mode?: 'standalone' | 'account' | 'broker';
     /**
      * For `device-adoption` integration addons (Approach A): the broker
      * kind the integration wizard must create or link (e.g.

package/dist/interfaces/api-responses.d.ts

@@ -97,6 +97,13 @@ export interface IntegrationTypeInfo {
     readonly iconUrl: string | null;
     readonly color: string;
     readonly instanceMode: 'unique' | 'multiple';
+    /**
+     * Integration wizard `mode` — how the Add-Integration flow behaves:
+     * `'standalone'` (create immediately → add devices, no config),
+     * `'account'` (config step), or `'broker'` (broker step). Derived by
+     * `getAvailableTypes` when the manifest omits an explicit `mode`.
+     */
+    readonly mode: 'standalone' | 'account' | 'broker';
     readonly discoveryMode: string;
     readonly existingInstances: ReadonlyArray<{
         readonly id: string;

package/dist/interfaces/capability.d.ts

@@ -1,20 +1,20 @@
-import type { ISettingsBackend, IEmbeddingsBackend } from './storage.js';
-import type { ILogDestination } from './logging.js';
-import type { IAddonPageProvider } from './addon.js';
 import type { IAuthProvider } from '../capabilities/auth-provider.cap.js';
-import type { IAddonRouteProvider } from './addon-routes.js';
-import type { IRestreamer } from './restreamer.js';
-import type { IWebRtcProvider } from './webrtc-provider.js';
-import type { streamBrokerCapability } from '../capabilities/stream-broker.cap.js';
 import type { InferProvider } from '../capabilities/capability-definition.js';
 import type { ISnapshotOrchestrator } from '../capabilities/snapshot.cap.js';
-import type { IStreamingEngine } from './streaming.js';
+import type { streamBrokerCapability } from '../capabilities/stream-broker.cap.js';
+import type { CollectionCapabilityName, SingletonCapabilityName } from '../generated/capability-router-map.js';
+import type { StepDefinition } from '../types/pipeline-step.js';
+import type { IAddonPageProvider } from './addon.js';
+import type { IAddonRouteProvider } from './addon-routes.js';
+import type { IDecoderProvider } from './decoder.js';
+import type { ILogDestination } from './logging.js';
 import type { IPipelineExecutorProvider } from './pipeline-executor-capability.js';
 import type { IPipelineOrchestratorProvider } from './pipeline-orchestrator-capability.js';
 import type { IPipelineRunnerProvider } from './pipeline-runner-capability.js';
-import type { IDecoderProvider } from './decoder.js';
-import type { StepDefinition } from '../types/pipeline-step.js';
-import type { SingletonCapabilityName, CollectionCapabilityName } from '../generated/capability-router-map.js';
+import type { IRestreamer } from './restreamer.js';
+import type { IEmbeddingsBackend, ISettingsBackend } from './storage.js';
+import type { IStreamingEngine } from './streaming.js';
+import type { IWebRtcProvider } from './webrtc-provider.js';
 /**
  * Pipeline step capability — each step is a separate capability
  * named `pipeline-step:{stepId}` (e.g., `pipeline-step:object-detection`).

package/dist/lifecycle/job.d.ts

@@ -20,8 +20,8 @@ export declare const taskPhaseSchema: z.ZodEnum<{
 }>;
 export type TaskPhase = z.infer<typeof taskPhaseSchema>;
 export declare const taskTargetSchema: z.ZodEnum<{
-    addon: "addon";
     framework: "framework";
+    addon: "addon";
 }>;
 export type TaskTarget = z.infer<typeof taskTargetSchema>;
 export declare const taskLogEntrySchema: z.ZodObject<{
@@ -50,8 +50,8 @@ export declare const lifecycleTaskSchema: z.ZodObject<{
     fromVersion: z.ZodNullable<z.ZodString>;
     toVersion: z.ZodString;
     target: z.ZodEnum<{
-        addon: "addon";
         framework: "framework";
+        addon: "addon";
     }>;
     phase: z.ZodEnum<{
         failed: "failed";
@@ -126,8 +126,8 @@ export declare const lifecycleJobSchema: z.ZodObject<{
         fromVersion: z.ZodNullable<z.ZodString>;
         toVersion: z.ZodString;
         target: z.ZodEnum<{
-            addon: "addon";
             framework: "framework";
+            addon: "addon";
         }>;
         phase: z.ZodEnum<{
             failed: "failed";

package/dist/{sleep-CKc4LLbD.js → sleep-BQzZ7joF.js}

@@ -2162,6 +2162,12 @@ var DeviceType = /* @__PURE__ */ function(DeviceType) {
 	DeviceType["Switch"] = "switch";
 	DeviceType["Sensor"] = "sensor";
 	DeviceType["Thermostat"] = "thermostat";
+	/** Air-conditioner / heat-pump climate device (HVAC) — shares the
+	*  `climate-control` cap surface with `Thermostat` but renders a
+	*  dedicated AC-appropriate control UI (mode chips, fan speed,
+	*  independent vertical/horizontal swing). Sources: native Gree, and
+	*  reusable by other AC integrations. */
+	DeviceType["Climate"] = "climate";
 	DeviceType["Button"] = "button";
 	/** Generic stateless event emitter — carries a device's EXACT declared
 	*  event vocabulary verbatim (no normalization). Installed with the

package/dist/{sleep-B3AOslwX.mjs → sleep-C2M2zF7x.mjs}

@@ -2162,6 +2162,12 @@ var DeviceType = /* @__PURE__ */ function(DeviceType) {
 	DeviceType["Switch"] = "switch";
 	DeviceType["Sensor"] = "sensor";
 	DeviceType["Thermostat"] = "thermostat";
+	/** Air-conditioner / heat-pump climate device (HVAC) — shares the
+	*  `climate-control` cap surface with `Thermostat` but renders a
+	*  dedicated AC-appropriate control UI (mode chips, fan speed,
+	*  independent vertical/horizontal swing). Sources: native Gree, and
+	*  reusable by other AC integrations. */
+	DeviceType["Climate"] = "climate";
 	DeviceType["Button"] = "button";
 	/** Generic stateless event emitter — carries a device's EXACT declared
 	*  event vocabulary verbatim (no normalization). Installed with the

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@camstack/types",
-  "version": "1.1.10",
+  "version": "1.1.12",
   "description": "Shared types, interfaces, and model catalogs for the CamStack detection ecosystem",
   "keywords": [
     "camstack",