@camstack/types 1.2.275 → 1.2.277

package/dist/capabilities/recording-onboard.cap.d.ts

@@ -71,8 +71,8 @@ export declare const RecordTriggerSchema: z.ZodEnum<{
     vehicle: "vehicle";
     animal: "animal";
     motion: "motion";
-    loitering: "loitering";
     continuous: "continuous";
+    loitering: "loitering";
     lineCrossing: "lineCrossing";
     intrusion: "intrusion";
     alarmInput: "alarmInput";
@@ -93,8 +93,8 @@ export declare const RecordWindowSchema: z.ZodObject<{
         vehicle: "vehicle";
         animal: "animal";
         motion: "motion";
-        loitering: "loitering";
         continuous: "continuous";
+        loitering: "loitering";
         lineCrossing: "lineCrossing";
         intrusion: "intrusion";
         alarmInput: "alarmInput";
@@ -221,8 +221,8 @@ export declare const RecordingOnboardStatusSchema: z.ZodObject<{
             vehicle: "vehicle";
             animal: "animal";
             motion: "motion";
-            loitering: "loitering";
             continuous: "continuous";
+            loitering: "loitering";
             lineCrossing: "lineCrossing";
             intrusion: "intrusion";
             alarmInput: "alarmInput";
@@ -292,8 +292,8 @@ export declare const OnboardScheduleSupportSchema: z.ZodObject<{
         vehicle: "vehicle";
         animal: "animal";
         motion: "motion";
-        loitering: "loitering";
         continuous: "continuous";
+        loitering: "loitering";
         lineCrossing: "lineCrossing";
         intrusion: "intrusion";
         alarmInput: "alarmInput";
@@ -383,8 +383,8 @@ export declare const RecordingOnboardOptionsSchema: z.ZodObject<{
             vehicle: "vehicle";
             animal: "animal";
             motion: "motion";
-            loitering: "loitering";
             continuous: "continuous";
+            loitering: "loitering";
             lineCrossing: "lineCrossing";
             intrusion: "intrusion";
             alarmInput: "alarmInput";
@@ -413,8 +413,8 @@ export declare const RecordingOnboardPatchSchema: z.ZodObject<{
             vehicle: "vehicle";
             animal: "animal";
             motion: "motion";
-            loitering: "loitering";
             continuous: "continuous";
+            loitering: "loitering";
             lineCrossing: "lineCrossing";
             intrusion: "intrusion";
             alarmInput: "alarmInput";
@@ -533,8 +533,8 @@ export declare const recordingOnboardCapability: {
                     vehicle: "vehicle";
                     animal: "animal";
                     motion: "motion";
-                    loitering: "loitering";
                     continuous: "continuous";
+                    loitering: "loitering";
                     lineCrossing: "lineCrossing";
                     intrusion: "intrusion";
                     alarmInput: "alarmInput";
@@ -556,8 +556,8 @@ export declare const recordingOnboardCapability: {
                         vehicle: "vehicle";
                         animal: "animal";
                         motion: "motion";
-                        loitering: "loitering";
                         continuous: "continuous";
+                        loitering: "loitering";
                         lineCrossing: "lineCrossing";
                         intrusion: "intrusion";
                         alarmInput: "alarmInput";
@@ -614,8 +614,8 @@ export declare const recordingOnboardCapability: {
                     vehicle: "vehicle";
                     animal: "animal";
                     motion: "motion";
-                    loitering: "loitering";
                     continuous: "continuous";
+                    loitering: "loitering";
                     lineCrossing: "lineCrossing";
                     intrusion: "intrusion";
                     alarmInput: "alarmInput";
@@ -674,8 +674,8 @@ export declare const recordingOnboardCapability: {
                 vehicle: "vehicle";
                 animal: "animal";
                 motion: "motion";
-                loitering: "loitering";
                 continuous: "continuous";
+                loitering: "loitering";
                 lineCrossing: "lineCrossing";
                 intrusion: "intrusion";
                 alarmInput: "alarmInput";

package/dist/composition/composable-caps.d.ts

@@ -0,0 +1,70 @@
+/**
+ * What a composition may BUILD on a device type (G2, D676): the caps a new
+ * device of that type, or an existing one that lacks them, can be given. The
+ * blockers are the validator's own refusal codes, and a spec compares this
+ * listing with `planComposition` for every capability — the editor can never
+ * offer a feature the save would refuse for the same reason.
+ */
+import { z } from 'zod';
+import type { CapabilityDefinition } from '../capabilities/capability-definition.js';
+import type { DeviceType } from '../device/device-type.js';
+import { type CompositionProblemCode } from './composition-report.js';
+export declare const ComposableFieldSchema: z.ZodObject<{
+    path: z.ZodString;
+    kind: z.ZodEnum<{
+        string: "string";
+        number: "number";
+        boolean: "boolean";
+        enum: "enum";
+    }>;
+    nullable: z.ZodBoolean;
+    required: z.ZodBoolean;
+    enumValues: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+export type ComposableField = z.infer<typeof ComposableFieldSchema>;
+export declare const ComposableCapabilitySchema: z.ZodObject<{
+    cap: z.ZodString;
+    fields: z.ZodArray<z.ZodObject<{
+        path: z.ZodString;
+        kind: z.ZodEnum<{
+            string: "string";
+            number: "number";
+            boolean: "boolean";
+            enum: "enum";
+        }>;
+        nullable: z.ZodBoolean;
+        required: z.ZodBoolean;
+        enumValues: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>>;
+    itemArray: z.ZodOptional<z.ZodObject<{
+        path: z.ZodString;
+        keyField: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type ComposableCapability = z.infer<typeof ComposableCapabilitySchema>;
+export declare const ComposableCapabilitiesSchema: z.ZodObject<{
+    caps: z.ZodArray<z.ZodObject<{
+        cap: z.ZodString;
+        fields: z.ZodArray<z.ZodObject<{
+            path: z.ZodString;
+            kind: z.ZodEnum<{
+                string: "string";
+                number: "number";
+                boolean: "boolean";
+                enum: "enum";
+            }>;
+            nullable: z.ZodBoolean;
+            required: z.ZodBoolean;
+            enumValues: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        }, z.core.$strip>>;
+        itemArray: z.ZodOptional<z.ZodObject<{
+            path: z.ZodString;
+            keyField: z.ZodString;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type ComposableCapabilities = z.infer<typeof ComposableCapabilitiesSchema>;
+/** Why a cap cannot be BUILT (new device, or added to an existing one) on `deviceType`; [] = it can. */
+export declare function builtCapabilityBlockers(def: CapabilityDefinition, deviceType: DeviceType): readonly CompositionProblemCode[];
+/** Every cap with no blocker, sorted by name. */
+export declare function describeComposableCaps(defs: readonly CapabilityDefinition[], deviceType: DeviceType): readonly ComposableCapability[];

package/dist/composition/evaluate-field.d.ts

@@ -1,34 +1,3 @@
-/**
- * One composed field, evaluated from what its sources say NOW (D659).
- *
- * Pure. The composer calls it on every source change, and the slice-5 editor
- * will call it for its live preview, so both see the same answer.
- *
- * The rules (spec §2):
- *  - a source that is offline or unreadable keeps its last value and is marked
- *    STALE; the field is stale and keeps computing (D49);
- *  - a source that is GONE makes the field UNAVAILABLE, `fatal`, and never a
- *    plausible number (D393);
- *  - a source that is unavailable but NOT gone (e.g. a cap unregistered at
- *    runtime, R7b) makes the field UNAVAILABLE, non-fatal, `value: null`: it
- *    may come back on its own, no block failure is raised for it;
- *  - an expression that fails on a value makes the field unavailable for that
- *    value, and NOT fatal: the next value may compute.
- *
- * `confirmed` (D663, D49): whether a NON-fatal unavailability is an ANSWER — a
- * cap the provider unregistered and a re-read agreed, a field the source
- * reported without, an expression that failed on a value — or only the
- * absence of one (a failed read, a first or empty read, a source not tracked
- * yet). Only a confirmed unavailability may hand a `release`-mode field back
- * to the native provider; an unconfirmed one holds it on its last value.
- * Absent means NOT confirmed. Fatal is always confirmed.
- *
- * When an expression has more than one unavailable binding, a FATAL one always
- * wins the outcome, regardless of position: every binding is scanned before
- * the field is judged, so an earlier non-fatal binding (e.g. a cap that is
- * momentarily unregistered) can never hide a later fatal one (a deleted
- * source) behind an early return.
- */
 import type { ExpressionValue } from '../expression/ast.js';
 import { type StatefulExpressionMemory } from '../expression/expression-source.js';
 import { type CompositionFieldRead, type CompositionFieldSource } from './composition.js';

package/dist/composition/index.d.ts

@@ -2,6 +2,7 @@
  * Compositions: composed devices (D659). This is the module barrel; leaf files
  * inside @camstack/types import the deep modules, never this file.
  */
+export * from './composable-caps.js';
 export * from './composition.js';
 export * from './composition-events.js';
 export * from './composition-graph.js';
@@ -10,5 +11,6 @@ export * from './composition-report.js';
 export * from './evaluate-field.js';
 export * from './examples.js';
 export * from './expression-kinds.js';
+export * from './presets/doorbell-feature.js';
 export * from './state-fields.js';
 export * from './validate-composition.js';

package/dist/composition/presets/doorbell-feature.d.ts

@@ -0,0 +1,20 @@
+import type { CompositionFieldsFeature, CompositionSourceRef } from '../composition.js';
+/** A rise closer than this to the previous one is the same press (D671). */
+export declare const DOORBELL_RISE_DEBOUNCE_MS = 2000;
+/** One source cap of one device that rings: its level field and its transition time. */
+export interface DoorbellFeatureSource {
+    readonly source: CompositionSourceRef;
+    readonly cap: string;
+    readonly activeField: string;
+    readonly changedAtField: string;
+}
+export interface DoorbellFeatureInput {
+    /** The device the doorbell cap lands on — `pressCountSinceStart` reads its own `lastPressedAt`. */
+    readonly camera: CompositionSourceRef;
+    readonly sources: readonly DoorbellFeatureSource[];
+    readonly enabled: boolean;
+}
+/** Every source cap of `source` that `SOURCE_CAP_ACTIVE_FIELD` knows AND the device has bound. */
+export declare function doorbellFeatureSources(source: CompositionSourceRef, boundCaps: readonly string[]): readonly DoorbellFeatureSource[];
+/** The D671 feature, byte for byte what the migration writes. Throws on zero sources. */
+export declare function buildDoorbellCompositionFeature(input: DoorbellFeatureInput): CompositionFieldsFeature;

package/dist/generated/addon-api.d.ts

@@ -1631,6 +1631,13 @@ export type AppRouter = TrpcCoreRouter<{
             output: z.infer<typeof coreBlocksCapability.methods.getCustomization.output>;
             meta: object;
         }>;
+        listComposableCaps: TRPCQueryProcedure<{
+            input: {
+                [x: string]: unknown;
+            } & z.input<typeof coreBlocksCapability.methods.listComposableCaps.input>;
+            output: z.infer<typeof coreBlocksCapability.methods.listComposableCaps.output>;
+            meta: object;
+        }>;
         validateComposition: TRPCMutationProcedure<{
             input: {
                 [x: string]: unknown;
@@ -5508,6 +5515,34 @@ export type AppRouter = TrpcCoreRouter<{
             output: z.infer<typeof pipelineAnalyticsCapability.methods.listArchivedDebugNotes.output>;
             meta: object;
         }>;
+        setTrackRelation: TRPCMutationProcedure<{
+            input: {
+                [x: string]: unknown;
+            } & z.input<typeof pipelineAnalyticsCapability.methods.setTrackRelation.input>;
+            output: z.infer<typeof pipelineAnalyticsCapability.methods.setTrackRelation.output>;
+            meta: object;
+        }>;
+        clearTrackRelation: TRPCMutationProcedure<{
+            input: {
+                [x: string]: unknown;
+            } & z.input<typeof pipelineAnalyticsCapability.methods.clearTrackRelation.input>;
+            output: z.infer<typeof pipelineAnalyticsCapability.methods.clearTrackRelation.output>;
+            meta: object;
+        }>;
+        setTrackPurity: TRPCMutationProcedure<{
+            input: {
+                [x: string]: unknown;
+            } & z.input<typeof pipelineAnalyticsCapability.methods.setTrackPurity.input>;
+            output: z.infer<typeof pipelineAnalyticsCapability.methods.setTrackPurity.output>;
+            meta: object;
+        }>;
+        listTrackRelations: TRPCQueryProcedure<{
+            input: {
+                [x: string]: unknown;
+            } & z.input<typeof pipelineAnalyticsCapability.methods.listTrackRelations.input>;
+            output: z.infer<typeof pipelineAnalyticsCapability.methods.listTrackRelations.output>;
+            meta: object;
+        }>;
         listBirthDecisions: TRPCQueryProcedure<{
             input: {
                 [x: string]: unknown;
@@ -6390,6 +6425,13 @@ export type AppRouter = TrpcCoreRouter<{
             output: z.infer<typeof pipelineOrchestratorCapability.methods.getCameraStatuses.output>;
             meta: object;
         }>;
+        setCameraSensors: TRPCMutationProcedure<{
+            input: {
+                [x: string]: unknown;
+            } & z.input<typeof pipelineOrchestratorCapability.methods.setCameraSensors.input>;
+            output: z.infer<typeof pipelineOrchestratorCapability.methods.setCameraSensors.output>;
+            meta: object;
+        }>;
         reconcileFromDisk: TRPCMutationProcedure<{
             input: {
                 nodeId?: string | undefined;

package/dist/generated/method-access-map.d.ts

@@ -6,7 +6,7 @@
  * scope+access check inside `protectedProcedure` (see
  * `server/backend/src/api/trpc/trpc.middleware.ts`).
  *
- * Coverage: 1189 method paths across 162 capabilities.
+ * Coverage: 1195 method paths across 162 capabilities.
  */
 import type { CapabilityMethodAccess } from '../capabilities/capability-definition.js';
 export interface MethodAccessRecord {

package/dist/generated/method-device-selectors.d.ts

@@ -6,8 +6,8 @@
  * system-scope cap that takes a deviceId was previously never device-filtered
  * — see the generator header).
  *
- * Coverage: 402 methods carry a device reference, of which
- * 143 are on SYSTEM-scope caps.
+ * Coverage: 407 methods carry a device reference, of which
+ * 144 are on SYSTEM-scope caps.
  *
  * Top-level fields, number arrays, and one-level arrays of objects carrying
  * a numeric device field (targets[].deviceId) are all mapped; the matcher

package/dist/generated/system-proxy.d.ts

@@ -65,7 +65,7 @@ export interface SystemProxy {
     readonly backup: Pick<InferProvider<typeof backupCapability>, 'listDestinations' | 'trigger' | 'listRuns' | 'cancel' | 'list' | 'listLocations' | 'getEntries' | 'restore' | 'delete' | 'listArchives' | 'upsertDestinationPolicy' | 'previewSchedule' | 'listSchedules' | 'upsertSchedule' | 'deleteSchedule'>;
     readonly broker: Pick<InferProvider<typeof brokerCapability>, 'list' | 'get' | 'listProviders' | 'add' | 'remove' | 'testConnection' | 'getSettings' | 'setSettings' | 'getBrokerConfig' | 'getSettingsSchema' | 'testSettings' | 'publish' | 'subscribe' | 'unsubscribe' | 'getState' | 'getStatus'>;
     readonly connectionTest: Pick<InferProvider<typeof connectionTestCapability>, 'testSettings' | 'describeTest'>;
-    readonly coreBlocks: Pick<InferProvider<typeof coreBlocksCapability>, 'list' | 'get' | 'create' | 'update' | 'delete' | 'setEnabled' | 'restart' | 'compile' | 'getTypeDefs' | 'createComposition' | 'updateComposition' | 'getComposition' | 'listCompositions' | 'getCustomization' | 'validateComposition'>;
+    readonly coreBlocks: Pick<InferProvider<typeof coreBlocksCapability>, 'list' | 'get' | 'create' | 'update' | 'delete' | 'setEnabled' | 'restart' | 'compile' | 'getTypeDefs' | 'createComposition' | 'updateComposition' | 'getComposition' | 'listCompositions' | 'getCustomization' | 'listComposableCaps' | 'validateComposition'>;
     readonly decoder: Pick<InferProvider<typeof decoderCapability>, 'supportsCodec' | 'getInfo' | 'createSession' | 'destroySession' | 'pushPacket' | 'openStream' | 'pullFrames' | 'pullHandles' | 'getFrame' | 'getShmStats' | 'updateConfig' | 'getStats' | 'listActiveSessions' | 'reprobeHwaccel'>;
     readonly deviceAdoption: Pick<InferProvider<typeof deviceAdoptionCapability>, 'listCandidateFilters' | 'listCandidates' | 'getCandidate' | 'refresh' | 'adopt' | 'release' | 'resync'>;
     readonly deviceExport: Pick<InferProvider<typeof deviceExportCapability>, 'getStatus' | 'listSupportedDeviceKinds' | 'listExposedDevices' | 'exposeDevice' | 'unexposeDevice'>;
@@ -86,7 +86,7 @@ export interface SystemProxy {
     readonly notificationRules: Pick<InferProvider<typeof notificationRulesCapability>, 'listRules' | 'getRule' | 'createRule' | 'updateRule' | 'deleteRule' | 'setRuleEnabled' | 'getClipRetentionAsks' | 'listDeviceMutes' | 'testRule' | 'previewStateSummary' | 'getConditionCatalog' | 'getTemplateCatalog' | 'previewTemplate' | 'getHistory' | 'getRuleLastRuns' | 'resolveArtifactUrl' | 'listSnoozes' | 'createSnooze' | 'cancelSnooze' | 'getAlarmConfig' | 'setAlarmConfig'>;
     readonly osdManager: Pick<InferProvider<typeof osdManagerCapability>, 'getConditionSupport' | 'copyDeviceConfiguration'>;
     readonly pipelineExecutor: Pick<InferProvider<typeof pipelineExecutorCapability>, 'getAvailableEngines' | 'getSelectedEngine' | 'getDefaultSteps' | 'getEngineProvisioning' | 'getVideoPipelineSteps' | 'setVideoPipelineSteps' | 'clearDeviceOverrides' | 'getInferenceDeviceHealth' | 'rearmInferenceDevice' | 'getSchema' | 'getGlobalSteps' | 'getGlobalPipelineConfig' | 'getOrchestratorConfigSchema' | 'validatePipeline' | 'listTemplates' | 'saveTemplate' | 'updateTemplate' | 'deleteTemplate' | 'getCapabilities' | 'getAddonModels' | 'downloadModel' | 'deleteModel' | 'cacheFrameInPool' | 'inferCached' | 'uncacheFrame' | 'getEffectiveTuning' | 'listLoadedEngines' | 'spinEngine' | 'killEngine' | 'listReferenceImages' | 'getReferenceImage' | 'getReferenceAudioFiles' | 'getReferenceAudio' | 'getAudioCapabilities' | 'runAudioTest' | 'getDetectionConfigSchema'>;
-    readonly pipelineOrchestrator: Pick<InferProvider<typeof pipelineOrchestratorCapability>, 'pauseForStorageMigration' | 'resumeForStorageMigration' | 'rebalance' | 'getPipelineAssignments' | 'getAgentLoad' | 'getClusterModelChoice' | 'getGlobalMetrics' | 'getCapabilityBindings' | 'setCapabilityBinding' | 'getIngestOwner' | 'getAudioNodeLoad' | 'getAudioAssignments' | 'getAgentSettings' | 'listAgentSettings' | 'removeAgentSettings' | 'setAgentMaxCameras' | 'setAgentDetectWeight' | 'setAgentCapabilities' | 'setAgentDecodeLimits' | 'setAgentReachableHost' | 'setAgentInferenceDevices' | 'getNodeInferenceDevices' | 'resetNodePipelineDefaults' | 'getCameraStatuses' | 'reconcileFromDisk' | 'getReconcileFromDiskStatus' | 'listTemplates' | 'saveTemplate' | 'updateTemplate' | 'deleteTemplate'>;
+    readonly pipelineOrchestrator: Pick<InferProvider<typeof pipelineOrchestratorCapability>, 'pauseForStorageMigration' | 'resumeForStorageMigration' | 'rebalance' | 'getPipelineAssignments' | 'getAgentLoad' | 'getClusterModelChoice' | 'getGlobalMetrics' | 'getCapabilityBindings' | 'setCapabilityBinding' | 'getIngestOwner' | 'getAudioNodeLoad' | 'getAudioAssignments' | 'getAgentSettings' | 'listAgentSettings' | 'removeAgentSettings' | 'setAgentMaxCameras' | 'setAgentDetectWeight' | 'setAgentCapabilities' | 'setAgentDecodeLimits' | 'setAgentReachableHost' | 'setAgentInferenceDevices' | 'getNodeInferenceDevices' | 'resetNodePipelineDefaults' | 'getCameraStatuses' | 'setCameraSensors' | 'reconcileFromDisk' | 'getReconcileFromDiskStatus' | 'listTemplates' | 'saveTemplate' | 'updateTemplate' | 'deleteTemplate'>;
     readonly pipelineRunner: Pick<InferProvider<typeof pipelineRunnerCapability>, 'attachCamera' | 'reportMotion' | 'getLocalLoad' | 'getLocalMetrics' | 'getAllCameraMetrics' | 'getLocalCameras' | 'getNativeCrop' | 'runStatelessStep'>;
     readonly plateGallery: Pick<InferProvider<typeof plateGalleryCapability>, 'getPlateMedia' | 'searchPlates' | 'suggestPlateClusters' | 'correctPlateText' | 'deletePlate' | 'listVehicles' | 'createVehicle' | 'renameVehicle' | 'deleteVehicle' | 'listVehicleSamples' | 'removeVehicleSample' | 'assignPlate' | 'unassignPlate' | 'assignPlates' | 'unassignPlates'>;
     readonly recordingArchive: Pick<InferProvider<typeof recordingArchiveCapability>, 'getAvailabilityBatch' | 'getDaysWithRecordingsBatch' | 'getStorageUsage' | 'listOpsLog' | 'pauseForStorageMigration' | 'resumeForStorageMigration' | 'refreshStorageLocationsForMigration' | 'startStorageMigrationMove' | 'getStorageMigrationMoveStatus' | 'cancelStorageMigrationMove' | 'relocateFootage' | 'listRelocateJobs' | 'getRelocateResidue' | 'reconcileLedgerAgainstDisk' | 'cancelRelocateJob' | 'planStorageRebalance' | 'startStorageRebalance' | 'getPlacement' | 'setDevicePlacement'>;

package/dist/index.d.ts

@@ -52,6 +52,7 @@ export { collectSecretConfigKeys, isSecretConfigField, REDACTED_SECRET, schemaDe
 export type * from './interfaces/context.js';
 export * from './interfaces/birth-decision-ledger.js';
 export * from './interfaces/debug-note-archive.js';
+export * from './interfaces/track-relations.js';
 export type * from './interfaces/decoder.js';
 export type * from './interfaces/detection-addon.js';
 export type { DeviceEvent, DeviceMetadata, DeviceState } from './interfaces/device.js';