@camstack/types 1.2.167 → 1.2.169

package/dist/capabilities/face-gallery.cap.d.ts

@@ -19,6 +19,63 @@ declare const IdentitySampleInfoSchema: z.ZodObject<{
     base64: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 export type IdentitySampleInfo = z.infer<typeof IdentitySampleInfoSchema>;
+/**
+ * One enrolled sample, judged against the gallery it lives in.
+ *
+ * The gallery is the one input to recognition nobody re-reads: a sample
+ * enrolled from the wrong face keeps voting forever, and because the matches it
+ * pulls then look confident, nobody goes back. The 2026-09-08 audit found
+ * exactly one such pair on this cluster — a sample scoring 0.61 against three
+ * samples of ANOTHER person, enrolled from the same camera in the same minute,
+ * where every other cross-identity pair sits under 0.50.
+ */
+declare const IdentitySampleAuditRowSchema: z.ZodObject<{
+    sampleId: z.ZodString;
+    enrolledAt: z.ZodNumber;
+    deviceId: z.ZodOptional<z.ZodNumber>;
+    source: z.ZodEnum<{
+        detected: "detected";
+        photo: "photo";
+    }>;
+    mediaKey: z.ZodOptional<z.ZodString>;
+    comparable: z.ZodBoolean;
+    selfMean: z.ZodNullable<z.ZodNumber>;
+    bestForeign: z.ZodOptional<z.ZodObject<{
+        identityId: z.ZodString;
+        name: z.ZodString;
+        score: z.ZodNumber;
+    }, z.core.$strip>>;
+    suspicion: z.ZodNumber;
+}, z.core.$strip>;
+export type IdentitySampleAuditRow = z.infer<typeof IdentitySampleAuditRowSchema>;
+declare const IdentitySampleAuditSchema: z.ZodObject<{
+    identityId: z.ZodString;
+    name: z.ZodString;
+    modelId: z.ZodString;
+    totalSamples: z.ZodNumber;
+    comparableSamples: z.ZodNumber;
+    flagged: z.ZodNumber;
+    flagThreshold: z.ZodNumber;
+    rows: z.ZodReadonly<z.ZodArray<z.ZodObject<{
+        sampleId: z.ZodString;
+        enrolledAt: z.ZodNumber;
+        deviceId: z.ZodOptional<z.ZodNumber>;
+        source: z.ZodEnum<{
+            detected: "detected";
+            photo: "photo";
+        }>;
+        mediaKey: z.ZodOptional<z.ZodString>;
+        comparable: z.ZodBoolean;
+        selfMean: z.ZodNullable<z.ZodNumber>;
+        bestForeign: z.ZodOptional<z.ZodObject<{
+            identityId: z.ZodString;
+            name: z.ZodString;
+            score: z.ZodNumber;
+        }, z.core.$strip>>;
+        suspicion: z.ZodNumber;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+export type IdentitySampleAudit = z.infer<typeof IdentitySampleAuditSchema>;
 declare const FaceInfoSchema: z.ZodObject<{
     faceId: z.ZodString;
     deviceId: z.ZodNumber;
@@ -122,6 +179,47 @@ export declare const faceGalleryCapability: {
             deviceId: z.ZodOptional<z.ZodNumber>;
             base64: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>>>, import("./capability-definition.js").CapabilityMethodKind>;
+        /**
+         * Re-analyse ONE person's enrolled samples against the whole gallery.
+         *
+         * A pure read — no write, no inference, just dot products over vectors the
+         * hub already holds (327 of them on this cluster). `admin` for the same
+         * reason `listIdentitySamples` is: the answer names every enrolled person
+         * and how well one person's samples match them, which is the gallery's
+         * shape and not a viewer-level fact.
+         *
+         * Removal deliberately stays `removeSample`: an analysis that could also
+         * delete would be one confirmation away from emptying a gallery.
+         */
+        readonly auditIdentitySamples: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
+            identityId: z.ZodString;
+        }, z.core.$strip>, z.ZodObject<{
+            identityId: z.ZodString;
+            name: z.ZodString;
+            modelId: z.ZodString;
+            totalSamples: z.ZodNumber;
+            comparableSamples: z.ZodNumber;
+            flagged: z.ZodNumber;
+            flagThreshold: z.ZodNumber;
+            rows: z.ZodReadonly<z.ZodArray<z.ZodObject<{
+                sampleId: z.ZodString;
+                enrolledAt: z.ZodNumber;
+                deviceId: z.ZodOptional<z.ZodNumber>;
+                source: z.ZodEnum<{
+                    detected: "detected";
+                    photo: "photo";
+                }>;
+                mediaKey: z.ZodOptional<z.ZodString>;
+                comparable: z.ZodBoolean;
+                selfMean: z.ZodNullable<z.ZodNumber>;
+                bestForeign: z.ZodOptional<z.ZodObject<{
+                    identityId: z.ZodString;
+                    name: z.ZodString;
+                    score: z.ZodNumber;
+                }, z.core.$strip>>;
+                suspicion: z.ZodNumber;
+            }, z.core.$strip>>>;
+        }, z.core.$strip>, import("./capability-definition.js").CapabilityMethodKind>;
         readonly removeSample: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
             identityId: z.ZodString;
             sampleId: z.ZodString;

package/dist/capabilities/index.d.ts

@@ -149,7 +149,7 @@ export { type DoorbellPressEvent, DoorbellPressEventSchema, type DoorbellStatus,
 export { type EnumSensorDateTimeFormat, EnumSensorDateTimeFormatSchema, type EnumSensorStatus, EnumSensorStatusSchema, enumSensorCapability, type IEnumSensorProvider, } from './enum-sensor.cap.js';
 export { type EventEmitterStatus, EventEmitterStatusSchema, type EventFire, EventFireSchema, eventEmitterCapability, type IEventEmitterProvider, } from './event-emitter.cap.js';
 export { EventItemSchema, eventsCapability, type IEventsProvider } from './events.cap.js';
-export { type FaceCluster, type FaceInfo, type FaceSortDirection, type FaceSortField, faceGalleryCapability, type Identity, type IdentitySampleInfo, type IFaceGalleryProvider, type ListRecentFacesInput, type SuggestFaceClustersInput, } from './face-gallery.cap.js';
+export { type FaceCluster, type FaceInfo, type FaceSortDirection, type FaceSortField, faceGalleryCapability, type Identity, type IdentitySampleAudit, type IdentitySampleAuditRow, type IdentitySampleInfo, type IFaceGalleryProvider, type ListRecentFacesInput, type SuggestFaceClustersInput, } from './face-gallery.cap.js';
 export { type FanControlStatus, FanControlStatusSchema, type FanDirection, FanDirectionSchema, fanControlCapability, type IFanControlProvider, } from './fan-control.cap.js';
 export { type FeatureProbeStatus, FeatureProbeStatusSchema, featureProbeCapability, type IFeatureProbeProvider, } from './feature-probe.cap.js';
 export { type FloodStatus, FloodStatusSchema, floodCapability, type IFloodProvider, } from './flood.cap.js';

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

@@ -2977,6 +2977,13 @@ export type AppRouter = TrpcCoreRouter<{
             output: z.infer<typeof faceGalleryCapability.methods.listIdentitySamples.output>;
             meta: object;
         }>;
+        auditIdentitySamples: TRPCQueryProcedure<{
+            input: {
+                [x: string]: unknown;
+            } & z.input<typeof faceGalleryCapability.methods.auditIdentitySamples.input>;
+            output: z.infer<typeof faceGalleryCapability.methods.auditIdentitySamples.output>;
+            meta: object;
+        }>;
         removeSample: TRPCMutationProcedure<{
             input: {
                 [x: string]: unknown;

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: 1021 method paths across 129 capabilities.
+ * Coverage: 1022 method paths across 129 capabilities.
  */
 import type { CapabilityMethodAccess } from '../capabilities/capability-definition.js';
 export interface MethodAccessRecord {

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

@@ -71,7 +71,7 @@ export interface SystemProxy {
     readonly deviceManager: Pick<InferProvider<typeof deviceManagerCapability>, 'allocateDeviceId' | 'migrateDevice' | 'registerDevice' | 'removeDevice' | 'persistConfig' | 'getRoleDisplayDefaults' | 'setRoleDisplayDefaults' | 'listLocations' | 'addLocation' | 'removeLocation' | 'renameLocation' | 'listPersistedByAddon' | 'listAll' | 'getChildren' | 'getChildrenBatch' | 'getLinkedDevicesBatch' | 'removeByIntegration' | 'getBindingsBatch' | 'getAllBindings' | 'listWrappersForCap' | 'listBindableCapsForDeviceType' | 'discoverDevices' | 'adoptDevice' | 'getCreationSchema' | 'createDevice' | 'testCreationField' | 'adoptionListCandidateFilters' | 'adoptionListCandidates' | 'adoptionRefresh' | 'adoptionAdopt' | 'adoptionRelease' | 'adoptionStartJob' | 'adoptionListJobs' | 'adoptionCancelJob' | 'adoptionResync' | 'discoveryProviders' | 'discoverAllProviders' | 'discoverProvider' | 'providerCreationType' | 'providerDiscoveryParamsSchema' | 'getDeviceStatusAggregateBatch'>;
     readonly deviceProvider: Pick<InferProvider<typeof deviceProviderCapability>, 'start' | 'stop' | 'getStatus' | 'getDevices' | 'supportsDiscovery' | 'discoverDevices' | 'getDiscoveryParamsSchema' | 'getManualCreationType' | 'adoptDiscoveredDevice' | 'supportsManualCreation' | 'getChildCreationSchema' | 'createDevice' | 'testCreationField'>;
     readonly deviceState: Pick<InferProvider<typeof deviceStateCapability>, 'getAllSnapshots'>;
-    readonly faceGallery: Pick<InferProvider<typeof faceGalleryCapability>, 'listIdentities' | 'createIdentity' | 'renameIdentity' | 'deleteIdentity' | 'listIdentitySamples' | 'removeSample' | 'getFaceMedia' | 'assignFace' | 'unassignFace' | 'deleteFace' | 'assignFaces' | 'unassignFaces' | 'suggestFaceClusters'>;
+    readonly faceGallery: Pick<InferProvider<typeof faceGalleryCapability>, 'listIdentities' | 'createIdentity' | 'renameIdentity' | 'deleteIdentity' | 'listIdentitySamples' | 'auditIdentitySamples' | 'removeSample' | 'getFaceMedia' | 'assignFace' | 'unassignFace' | 'deleteFace' | 'assignFaces' | 'unassignFaces' | 'suggestFaceClusters'>;
     readonly integrations: Pick<InferProvider<typeof integrationsCapability>, 'list' | 'get' | 'getByAddonId' | 'create' | 'update' | 'delete' | 'getSettings' | 'setSettings' | 'getAvailableTypes' | 'testConnection'>;
     readonly llm: Pick<InferProvider<typeof llmCapability>, 'generate' | 'generateVision' | 'cancel' | 'listProfileKinds' | 'listProfiles' | 'upsertProfile' | 'deleteProfile' | 'testProfile' | 'listModels' | 'getDefaults' | 'setDefault' | 'getUsage' | 'listModelCatalog' | 'listRuntimeNodes' | 'listNodeModels' | 'resolveModelRef' | 'installModel' | 'deleteModel' | 'getRuntimeStatus' | 'startRuntime' | 'stopRuntime'>;
     readonly localNetwork: Pick<InferProvider<typeof localNetworkCapability>, 'list' | 'getPreferred' | 'getConnectionEndpoints' | 'getNotificationEndpoint' | 'setNotificationEndpoint' | 'getViewerEndpoints' | 'setViewerEndpoints' | 'getAllowedAddresses' | 'setAllowedAddresses' | 'resetAllowlistToBestMatch' | 'getTlsStatus' | 'regenerateCertificate' | 'uploadCertificate' | 'downloadCa' | 'revertToGeneratedCertificate'>;