@camstack/types 1.2.326 → 1.2.327

package/dist/interfaces/config-ui.d.ts

@@ -80,7 +80,7 @@ export interface ConfigSection {
     readonly immediate?: boolean;
     readonly fields: readonly ConfigField[];
 }
-export type ConfigField = ConfigTextField | ConfigNumberField | ConfigBooleanField | ConfigSelectField | ConfigMultiSelectField | ConfigTimezoneField | ConfigDateTimeField | ConfigColorField | ConfigPasswordField | ConfigTextAreaField | ConfigSliderField | ConfigTagsField | ConfigScheduleField | ConfigGroupField | ConfigSubTabsField | ConfigSeparatorField | ConfigInfoField | ConfigQrCodeField | ConfigObjectArrayField | ConfigEditableArrayField | ConfigModelSelectorField | ConfigStorageLocationField | ConfigProbeField | ConfigButtonField | ConfigNodeSelectField | ConfigNodeMultiSelectField | ConfigDeviceSelectField | ConfigDeviceMultiSelectField | ConfigNotificationTargetSelectField | ConfigNotificationTargetMultiSelectField | ConfigWidgetField | ConfigAddonActionSelectField | ConfigAddonActionButtonField | ConfigDeviceActionButtonField;
+export type ConfigField = ConfigTextField | ConfigNumberField | ConfigBooleanField | ConfigSelectField | ConfigMultiSelectField | ConfigTimezoneField | ConfigDateTimeField | ConfigColorField | ConfigIconField | ConfigPasswordField | ConfigTextAreaField | ConfigSliderField | ConfigTagsField | ConfigScheduleField | ConfigGroupField | ConfigSubTabsField | ConfigSeparatorField | ConfigInfoField | ConfigQrCodeField | ConfigObjectArrayField | ConfigEditableArrayField | ConfigModelSelectorField | ConfigStorageLocationField | ConfigProbeField | ConfigButtonField | ConfigNodeSelectField | ConfigNodeMultiSelectField | ConfigDeviceSelectField | ConfigDeviceMultiSelectField | ConfigNotificationTargetSelectField | ConfigNotificationTargetMultiSelectField | ConfigWidgetField | ConfigAddonActionSelectField | ConfigAddonActionButtonField | ConfigDeviceActionButtonField;
 /**
  * Per-MODEL applicability of a pipeline-step setting (D214).
  *
@@ -389,6 +389,22 @@ export interface ConfigColorField extends ConfigFieldBase {
     type: 'color';
     presets?: string[];
 }
+/**
+ * An icon chosen from the shared display-icon vocabulary (D780) —
+ * `DISPLAY_ICON_VOCABULARY` in `device/display-icon-vocabulary.ts`, the same
+ * keys the device and room pickers store. The form renders the shared
+ * `<IconPicker>`; the stored value is a vocabulary KEY, never a free-text
+ * lucide name. `default` must itself be a vocabulary key: clearing the picker
+ * writes it back, and a stored value outside the vocabulary (a pre-D780
+ * free-text name) is drawn as the default — readers resolve it with
+ * `resolveDisplayIconKey(value, default)`.
+ *
+ * COMPILE-TIME ONLY on the wire (`z.custom<ConfigField>()`): a form that
+ * predates this type renders it through its default branch.
+ */
+export interface ConfigIconField extends ConfigFieldBase {
+    readonly type: 'icon';
+}
 /** Select a single cluster node from the live topology. Options are
  * populated dynamically by the UI via useClusterNodes — no server-side
  * option list needed. */
@@ -700,7 +716,7 @@ export interface ConfigOption {
  *
  * Constraints inside `itemFields`:
  *   - Only scalar field types are supported (text/number/select/
- *     multiselect/password/boolean/textarea/color/tags/slider). Nested
+ *     multiselect/password/boolean/textarea/color/icon/tags/slider). Nested
  *     groups, sub-tabs, probes, button actions, and other arrays are
  *     intentionally rejected — they conflate row-state with section-
  *     state and the FormBuilder's flat onChange contract can't carry
@@ -876,6 +892,17 @@ export interface ConfigAddonActionButtonField extends ConfigFieldBase {
      * No-op on a form with no device.
      */
     includeDeviceId?: boolean;
+    /**
+     * Ask the operator for one value when the button is pressed and send it as
+     * `input[param]`. For a one-shot argument that must not live in the saved
+     * settings (ids to delete, a code to send). Cancelling runs nothing.
+     */
+    prompt?: {
+        readonly param: string;
+        readonly title?: string;
+        readonly message?: string;
+        readonly placeholder?: string;
+    };
     /** Toast/inline success message template. `{key}` placeholders are
      *  resolved against the action result. */
     successMessage?: string;
@@ -943,6 +970,8 @@ export type ConfigFieldWithValue = (ConfigTextField & {
     readonly value: unknown;
 }) | (ConfigColorField & {
     readonly value: unknown;
+}) | (ConfigIconField & {
+    readonly value: unknown;
 }) | (ConfigPasswordField & {
     readonly value: unknown;
 }) | (ConfigTextAreaField & {

package/dist/{sleep-BNeXenvr.mjs → sleep-B0JG7-_F.mjs}

@@ -3415,6 +3415,8 @@ function createDeviceProxy(api, binding, opts) {
 		completeRetrainTrack: (input) => dispatch("pipeline-analytics", "pipelineAnalytics", "completeRetrainTrack", "mutation", input),
 		restageRetrainTrack: (input) => dispatch("pipeline-analytics", "pipelineAnalytics", "restageRetrainTrack", "mutation", input),
 		getRetrainExportUrl: (input) => dispatch("pipeline-analytics", "pipelineAnalytics", "getRetrainExportUrl", "query", input),
+		setRetrainFrameComplete: (input) => dispatch("pipeline-analytics", "pipelineAnalytics", "setRetrainFrameComplete", "mutation", input),
+		writeRetrainArchive: (input) => dispatch("pipeline-analytics", "pipelineAnalytics", "writeRetrainArchive", "mutation", input),
 		getEventMedia: (input) => dispatch("pipeline-analytics", "pipelineAnalytics", "getEventMedia", "query", input),
 		getTrackMedia: (input) => dispatch("pipeline-analytics", "pipelineAnalytics", "getTrackMedia", "query", input),
 		listTrackMedia: (input) => dispatch("pipeline-analytics", "pipelineAnalytics", "listTrackMedia", "query", input),
@@ -3921,6 +3923,94 @@ function createDeviceProxy(api, binding, opts) {
 	};
 }
 //#endregion
+//#region src/device/zod-secret.ts
+/**
+* Secret declaration on a Zod config schema (D783).
+*
+* A field is a secret because its schema SAYS so — `.meta({ secret: true })`,
+* spelled {@link SECRET_META} — never because its key looks like a credential.
+* It is the Zod twin of `secret: true` / `type: 'password'` on a config-UI
+* field (`isSecretConfigField`), and every consumer that treats secrets
+* specially reads it: the settings form (`zodEntriesToConfigUI`), the paths a
+* device advertises at `registerDevice` (`secretConfigPaths`, which the
+* non-admin redaction withholds at any depth), and the keychain later.
+*
+* Zod keeps `.meta()` in `z.globalRegistry`, which lives on `globalThis`, so a
+* declaration made by an addon's own copy of zod is visible here.
+*/
+/**
+* `{ secret: true }` — the one spelling of "this field holds a credential".
+*
+* Addons write the LITERAL `.meta({ secret: true })` rather than importing
+* this constant: an addon running against an older `@camstack/types` would
+* otherwise call `.meta(undefined)`, which in zod v4 is the metadata GETTER
+* and returns no schema at all.
+*/
+var SECRET_META = { secret: true };
+function defOf(schema) {
+	return schema._zod?.def ?? {};
+}
+function declaredHere(schema) {
+	return z.globalRegistry.get(schema)?.secret === true;
+}
+/** Wrapper kinds whose `innerType` is the field itself. */
+var WRAPPERS = new Set([
+	"optional",
+	"nullable",
+	"default",
+	"prefault",
+	"catch",
+	"readonly",
+	"nonoptional"
+]);
+/**
+* The schema layers that make up ONE field: the schema itself and every
+* wrapper below it (optional / default / nullable / readonly / catch), plus
+* both sides of a pipe (`z.preprocess` puts the real schema on `out`,
+* `.transform` on `in`).
+*/
+function layersOf(schema) {
+	const out = [];
+	const queue = [schema];
+	while (queue.length > 0) {
+		const s = queue.shift();
+		if (!s || out.includes(s)) continue;
+		out.push(s);
+		const def = defOf(s);
+		if (def.type !== void 0 && WRAPPERS.has(def.type) && def.innerType) queue.push(def.innerType);
+		if (def.type === "pipe") {
+			if (def.in) queue.push(def.in);
+			if (def.out) queue.push(def.out);
+		}
+	}
+	return out;
+}
+/** True when any layer of this field declares `.meta({ secret: true })`. */
+function isZodSecret(schema) {
+	return layersOf(schema).some(declaredHere);
+}
+/**
+* Every declared secret path in a config schema: dotted keys, `[]` for "each
+* element of this array" (`connection.password`, `rows[].token`). A declared
+* object or array is reported as one path and not descended into — everything
+* under it is secret.
+*/
+function collectZodSecretPaths(schema, prefix = "") {
+	if (isZodSecret(schema)) return prefix.length > 0 ? [prefix] : [];
+	const paths = [];
+	for (const layer of layersOf(schema)) {
+		const def = defOf(layer);
+		if (def.type === "object" && def.shape) for (const [key, child] of Object.entries(def.shape)) paths.push(...collectZodSecretPaths(child, prefix ? `${prefix}.${key}` : key));
+		else if (def.type === "array" && def.element) paths.push(...collectZodSecretPaths(def.element, `${prefix}[]`));
+		else if (def.type === "union" && def.options) for (const option of def.options) paths.push(...collectZodSecretPaths(option, prefix));
+		else if (def.type === "intersection") {
+			if (def.left) paths.push(...collectZodSecretPaths(def.left, prefix));
+			if (def.right) paths.push(...collectZodSecretPaths(def.right, prefix));
+		}
+	}
+	return [...new Set(paths)];
+}
+//#endregion
 //#region src/generated/device-scoped-caps.ts
 /**
 * AUTO-GENERATED by scripts/generate-device-scoped-caps.ts — DO NOT EDIT.
@@ -4183,4 +4273,4 @@ function sleepCancellable(ms, signal) {
 	});
 }
 //#endregion
-export { CamProfileSchema as $, DEVICE_STATUS_METHOD as A, isEvent as At, nodePin as B, isAudioChunkFormat as Bt, customAction as C, DisposerChain as Ct, adminUiCapability as D, createDurableState as Dt, deviceCustomAction as E, normalizeNodeId as Et, method as F, hydrateSchema as Ft, emitDownForOwnedCaps as G, toNodeId as H, optionalMethod as I, resolveHydratedFieldValue as It, AudioChunkFormatSchema as J, readinessKey as K, resolveCapMount as L, AUDIO_CHUNK_FORMATS as Lt, event as M, WELL_KNOWN_TAB_MAP as Mt, expandCapMethods as N, collectHydratedFieldEntries as Nt, DEFAULT_RUNTIME_STATE_DURABILITY as O, createEvent as Ot, isDeviceConfigCap as P, collectHydratedFieldValues as Pt, CAM_PROFILE_ORDER as Q, systemMethod as R, audioChunkBytesPerSample as Rt, DEVICE_CHILDREN_BATCH_MAX as S, SHARE_VIEW_KINDS as St, describeCustomActions as T, normalizeAddonInitResult as Tt, ReadinessRegistry as U, readNodePin as V, ReadinessTimeoutError as W, BrokerStatsSchema as X, AudioStreamPickSchema as Y, BrokerStatusSchema as Z, createMirrorSource as _, PEER_BYTES_MAX_OUTSTANDING as _t, asJsonObject as a, ProfileRtspEntrySchema as at, deviceOpsCapability as b, PeerBytesTicketSchema as bt, parseJsonArray as c, StreamSourceEntrySchema$1 as ct, BOOT_RECOVERY_BACKOFF_MS as d, SubscribeAudioChunksResultSchema as dt, CamStreamKindSchema as et, DEVICE_SCOPED_CAPS as f, makeProfileBrokerId as ft, createLazyTrpcSource as g, PEER_BYTES_CHUNK_BYTES as gt, createEventBusSliceSource as h, selectAssignedProfileSlots as ht, asJsonArray as i, FrameHandleSchema as it, PROVIDER_PIN_FIELD as j, WELL_KNOWN_TABS as jt, DEVICE_SETTINGS_CONTRIBUTION_METHODS as k, emitReadiness as kt, parseJsonObject as l, StreamSourceSchema as lt, createDeviceProxy as m, parseProfileBrokerId as mt, sleepCancellable as n, CameraStreamSchema as nt, asNumber as o, ProfileSlotSchema as ot, isDeviceScopedCap as p, makeSourceBrokerId as pt, scopeKey as q, asBoolean as r, DecodedAudioChunkSchema as rt, asString as s, ProfileSlotStatusSchema as st, sleep as t, CamStreamResolutionSchema as tt, parseJsonUnknown as u, SubscribeAudioChunksInputSchema as ut, createSliceHandle as v, PEER_BYTES_STALL_MS as vt, defineCustomActions as w, BaseAddon as wt, viewerUiCapability as x, DATAPLANE_SECRET_HEADER as xt, RawStateResultSchema as y, PEER_BYTES_TICKET_TTL_MS as yt, CAP_NODE_PIN_CONTEXT_KEY as z, expandAudioChunkToF32le as zt };
+export { BrokerStatsSchema as $, adminUiCapability as A, createDurableState as At, resolveCapMount as B, AUDIO_CHUNK_FORMATS as Bt, deviceOpsCapability as C, PeerBytesTicketSchema as Ct, defineCustomActions as D, BaseAddon as Dt, customAction as E, DisposerChain as Et, event as F, WELL_KNOWN_TAB_MAP as Ft, toNodeId as G, CAP_NODE_PIN_CONTEXT_KEY as H, expandAudioChunkToF32le as Ht, expandCapMethods as I, collectHydratedFieldEntries as It, emitDownForOwnedCaps as J, ReadinessRegistry as K, isDeviceConfigCap as L, collectHydratedFieldValues as Lt, DEVICE_SETTINGS_CONTRIBUTION_METHODS as M, emitReadiness as Mt, DEVICE_STATUS_METHOD as N, isEvent as Nt, describeCustomActions as O, normalizeAddonInitResult as Ot, PROVIDER_PIN_FIELD as P, WELL_KNOWN_TABS as Pt, AudioStreamPickSchema as Q, method as R, hydrateSchema as Rt, RawStateResultSchema as S, PEER_BYTES_TICKET_TTL_MS as St, DEVICE_CHILDREN_BATCH_MAX as T, SHARE_VIEW_KINDS as Tt, nodePin as U, isAudioChunkFormat as Ut, systemMethod as V, audioChunkBytesPerSample as Vt, readNodePin as W, scopeKey as X, readinessKey as Y, AudioChunkFormatSchema as Z, createDeviceProxy as _, parseProfileBrokerId as _t, asJsonObject as a, CameraStreamSchema as at, createMirrorSource as b, PEER_BYTES_MAX_OUTSTANDING as bt, parseJsonArray as c, ProfileRtspEntrySchema as ct, BOOT_RECOVERY_BACKOFF_MS as d, StreamSourceEntrySchema$1 as dt, BrokerStatusSchema as et, DEVICE_SCOPED_CAPS as f, StreamSourceSchema as ft, isZodSecret as g, makeSourceBrokerId as gt, collectZodSecretPaths as h, makeProfileBrokerId as ht, asJsonArray as i, CamStreamResolutionSchema as it, DEFAULT_RUNTIME_STATE_DURABILITY as j, createEvent as jt, deviceCustomAction as k, normalizeNodeId as kt, parseJsonObject as l, ProfileSlotSchema as lt, SECRET_META as m, SubscribeAudioChunksResultSchema as mt, sleepCancellable as n, CamProfileSchema as nt, asNumber as o, DecodedAudioChunkSchema as ot, isDeviceScopedCap as p, SubscribeAudioChunksInputSchema as pt, ReadinessTimeoutError as q, asBoolean as r, CamStreamKindSchema as rt, asString as s, FrameHandleSchema as st, sleep as t, CAM_PROFILE_ORDER as tt, parseJsonUnknown as u, ProfileSlotStatusSchema as ut, createEventBusSliceSource as v, selectAssignedProfileSlots as vt, viewerUiCapability as w, DATAPLANE_SECRET_HEADER as wt, createSliceHandle as x, PEER_BYTES_STALL_MS as xt, createLazyTrpcSource as y, PEER_BYTES_CHUNK_BYTES as yt, optionalMethod as z, resolveHydratedFieldValue as zt };

package/dist/{sleep-DPar9AHl.js → sleep-az1qiFzK.js}

@@ -3415,6 +3415,8 @@ function createDeviceProxy(api, binding, opts) {
 		completeRetrainTrack: (input) => dispatch("pipeline-analytics", "pipelineAnalytics", "completeRetrainTrack", "mutation", input),
 		restageRetrainTrack: (input) => dispatch("pipeline-analytics", "pipelineAnalytics", "restageRetrainTrack", "mutation", input),
 		getRetrainExportUrl: (input) => dispatch("pipeline-analytics", "pipelineAnalytics", "getRetrainExportUrl", "query", input),
+		setRetrainFrameComplete: (input) => dispatch("pipeline-analytics", "pipelineAnalytics", "setRetrainFrameComplete", "mutation", input),
+		writeRetrainArchive: (input) => dispatch("pipeline-analytics", "pipelineAnalytics", "writeRetrainArchive", "mutation", input),
 		getEventMedia: (input) => dispatch("pipeline-analytics", "pipelineAnalytics", "getEventMedia", "query", input),
 		getTrackMedia: (input) => dispatch("pipeline-analytics", "pipelineAnalytics", "getTrackMedia", "query", input),
 		listTrackMedia: (input) => dispatch("pipeline-analytics", "pipelineAnalytics", "listTrackMedia", "query", input),
@@ -3921,6 +3923,94 @@ function createDeviceProxy(api, binding, opts) {
 	};
 }
 //#endregion
+//#region src/device/zod-secret.ts
+/**
+* Secret declaration on a Zod config schema (D783).
+*
+* A field is a secret because its schema SAYS so — `.meta({ secret: true })`,
+* spelled {@link SECRET_META} — never because its key looks like a credential.
+* It is the Zod twin of `secret: true` / `type: 'password'` on a config-UI
+* field (`isSecretConfigField`), and every consumer that treats secrets
+* specially reads it: the settings form (`zodEntriesToConfigUI`), the paths a
+* device advertises at `registerDevice` (`secretConfigPaths`, which the
+* non-admin redaction withholds at any depth), and the keychain later.
+*
+* Zod keeps `.meta()` in `z.globalRegistry`, which lives on `globalThis`, so a
+* declaration made by an addon's own copy of zod is visible here.
+*/
+/**
+* `{ secret: true }` — the one spelling of "this field holds a credential".
+*
+* Addons write the LITERAL `.meta({ secret: true })` rather than importing
+* this constant: an addon running against an older `@camstack/types` would
+* otherwise call `.meta(undefined)`, which in zod v4 is the metadata GETTER
+* and returns no schema at all.
+*/
+var SECRET_META = { secret: true };
+function defOf(schema) {
+	return schema._zod?.def ?? {};
+}
+function declaredHere(schema) {
+	return zod.z.globalRegistry.get(schema)?.secret === true;
+}
+/** Wrapper kinds whose `innerType` is the field itself. */
+var WRAPPERS = new Set([
+	"optional",
+	"nullable",
+	"default",
+	"prefault",
+	"catch",
+	"readonly",
+	"nonoptional"
+]);
+/**
+* The schema layers that make up ONE field: the schema itself and every
+* wrapper below it (optional / default / nullable / readonly / catch), plus
+* both sides of a pipe (`z.preprocess` puts the real schema on `out`,
+* `.transform` on `in`).
+*/
+function layersOf(schema) {
+	const out = [];
+	const queue = [schema];
+	while (queue.length > 0) {
+		const s = queue.shift();
+		if (!s || out.includes(s)) continue;
+		out.push(s);
+		const def = defOf(s);
+		if (def.type !== void 0 && WRAPPERS.has(def.type) && def.innerType) queue.push(def.innerType);
+		if (def.type === "pipe") {
+			if (def.in) queue.push(def.in);
+			if (def.out) queue.push(def.out);
+		}
+	}
+	return out;
+}
+/** True when any layer of this field declares `.meta({ secret: true })`. */
+function isZodSecret(schema) {
+	return layersOf(schema).some(declaredHere);
+}
+/**
+* Every declared secret path in a config schema: dotted keys, `[]` for "each
+* element of this array" (`connection.password`, `rows[].token`). A declared
+* object or array is reported as one path and not descended into — everything
+* under it is secret.
+*/
+function collectZodSecretPaths(schema, prefix = "") {
+	if (isZodSecret(schema)) return prefix.length > 0 ? [prefix] : [];
+	const paths = [];
+	for (const layer of layersOf(schema)) {
+		const def = defOf(layer);
+		if (def.type === "object" && def.shape) for (const [key, child] of Object.entries(def.shape)) paths.push(...collectZodSecretPaths(child, prefix ? `${prefix}.${key}` : key));
+		else if (def.type === "array" && def.element) paths.push(...collectZodSecretPaths(def.element, `${prefix}[]`));
+		else if (def.type === "union" && def.options) for (const option of def.options) paths.push(...collectZodSecretPaths(option, prefix));
+		else if (def.type === "intersection") {
+			if (def.left) paths.push(...collectZodSecretPaths(def.left, prefix));
+			if (def.right) paths.push(...collectZodSecretPaths(def.right, prefix));
+		}
+	}
+	return [...new Set(paths)];
+}
+//#endregion
 //#region src/generated/device-scoped-caps.ts
 /**
 * AUTO-GENERATED by scripts/generate-device-scoped-caps.ts — DO NOT EDIT.
@@ -4387,6 +4477,12 @@ Object.defineProperty(exports, "ReadinessTimeoutError", {
 		return ReadinessTimeoutError;
 	}
 });
+Object.defineProperty(exports, "SECRET_META", {
+	enumerable: true,
+	get: function() {
+		return SECRET_META;
+	}
+});
 Object.defineProperty(exports, "SHARE_VIEW_KINDS", {
 	enumerable: true,
 	get: function() {
@@ -4483,6 +4579,12 @@ Object.defineProperty(exports, "collectHydratedFieldValues", {
 		return collectHydratedFieldValues;
 	}
 });
+Object.defineProperty(exports, "collectZodSecretPaths", {
+	enumerable: true,
+	get: function() {
+		return collectZodSecretPaths;
+	}
+});
 Object.defineProperty(exports, "createDeviceProxy", {
 	enumerable: true,
 	get: function() {
@@ -4615,6 +4717,12 @@ Object.defineProperty(exports, "isEvent", {
 		return isEvent;
 	}
 });
+Object.defineProperty(exports, "isZodSecret", {
+	enumerable: true,
+	get: function() {
+		return isZodSecret;
+	}
+});
 Object.defineProperty(exports, "makeProfileBrokerId", {
 	enumerable: true,
 	get: function() {

package/package.json

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