@camstack/types 1.2.75 → 1.2.77

package/dist/device/battery-presence.d.ts

@@ -0,0 +1,84 @@
+/**
+ * "Asleep" and "gone" are two different facts, and a battery camera reports
+ * neither by itself.
+ *
+ * A mains camera answers "are you there?" because something may ask it. A
+ * battery camera may not be asked: the question IS the damage — a Baichuan
+ * login on a sleeping Argus is itself a wake event, so a reachability poll
+ * that proves a camera is alive is the same poll that flattens it (D173).
+ *
+ * That leaves exactly one honest way to tell a healthy sleeper from a dead
+ * battery: **wait, and notice**. Every signal that reaches us WITHOUT us
+ * reaching for the camera — a firmware push, an inbound motion email, an
+ * observed wake, a round-trip somebody else's demand already paid for — stamps
+ * `BatteryStatus.lastContactAt`. Silence past a threshold is then a positive
+ * observation rather than an absence of one.
+ *
+ * ## Why this is a function and not a stored field
+ *
+ * The stored fact is the CONTACT. The verdict is a reading of it against a
+ * clock and a threshold, so storing the verdict would create a second
+ * authority that goes stale the moment nobody rewrites it — the exact shape
+ * D62 forbids for per-camera switches, for the same reason: two knobs that can
+ * disagree are worse than one. Every surface (badge, camera status, snapshot
+ * courtesy frame, stream error) calls this, so they cannot disagree.
+ *
+ * ## The failure direction
+ *
+ * Toward `sleeping`. `unreachable` is a FAULT — it lights a badge and it is
+ * meant to be believed — so it is only ever returned when we have positively
+ * seen silence for longer than the threshold. A slice we have never written
+ * (`lastContactAt` absent or 0) answers `sleeping`, never `unreachable`: a
+ * freshly-adopted camera, or one whose slice was lost, has told us nothing,
+ * and "we know nothing" must never be painted as "it is broken". That is D62's
+ * rule — disabled must never look like broken — applied to the third state.
+ */
+import type { BatteryStatus } from '../capabilities/battery.cap.js';
+/**
+ * What a battery-operated device is doing, as far as PASSIVE evidence can say.
+ *
+ * - `awake` — the firmware is up right now. Reads are cheap, streams dial.
+ * - `sleeping` — low-power, and that is NORMAL. Not a fault, never a fault
+ *   badge; a stream can still be had by asking for a wake.
+ * - `unreachable` — nothing passive has arrived for longer than the
+ *   threshold. Flat battery, off the LAN, unpaired. This IS a fault and the
+ *   surface must say so.
+ */
+export type BatteryPresence = 'awake' | 'sleeping' | 'unreachable';
+/**
+ * Default silence budget before a sleeping battery camera is called gone.
+ *
+ * Sized off the mechanism that produces contact, not off taste: a battery cam
+ * on this deployment surfaces a firmware push (battery level, sleep/wake, or a
+ * motion email) on the order of hours even with no visitors, and the snapshot
+ * wrapper's own battery window is 1 hour. Six hours is therefore several
+ * missed opportunities, not one — so a single quiet night does not raise a
+ * fault, and a genuinely flat camera is named well inside a day.
+ */
+export declare const BATTERY_UNREACHABLE_AFTER_MS: number;
+export interface BatteryPresenceInput {
+    /** The device's `battery` runtime-state slice, or `undefined` when it has none. */
+    readonly status: Pick<BatteryStatus, 'sleeping' | 'lastContactAt'> | undefined | null;
+    /** Clock. Pass explicitly from callers that already hold one. */
+    readonly nowMs: number;
+    /** Silence budget. Defaults to {@link BATTERY_UNREACHABLE_AFTER_MS}. */
+    readonly unreachableAfterMs?: number;
+}
+/**
+ * THE derivation. One crop rectangle, one presence verdict — see D52 for why
+ * this repo insists a derived value has exactly one implementation.
+ *
+ * `undefined` status ⇒ `sleeping`. A device with no slice has made no claim,
+ * and the caller decides separately whether it is even battery-operated
+ * (`DeviceFeature.BatteryOperated`); this function never answers that
+ * question, only what a battery device is doing.
+ */
+export declare function deriveBatteryPresence(input: BatteryPresenceInput): BatteryPresence;
+/**
+ * Is this presence a FAULT the operator should be told about?
+ *
+ * Exists so no surface has to re-decide it — the whole point of the third
+ * state is that `sleeping` stops being rendered as breakage, and a caller that
+ * writes `presence !== 'awake'` has silently undone that.
+ */
+export declare function isBatteryPresenceFault(presence: BatteryPresence): boolean;

package/dist/encode-profile.d.ts

@@ -30,11 +30,11 @@ export declare const VideoEncodeSchema: z.ZodObject<{
     gopFrames: z.ZodOptional<z.ZodNumber>;
     bf: z.ZodOptional<z.ZodNumber>;
     preset: z.ZodOptional<z.ZodEnum<{
-        fast: "fast";
         ultrafast: "ultrafast";
         superfast: "superfast";
         veryfast: "veryfast";
         faster: "faster";
+        fast: "fast";
         medium: "medium";
     }>>;
     tune: z.ZodOptional<z.ZodEnum<{
@@ -77,11 +77,11 @@ export declare const EncodeProfileSchema: z.ZodObject<{
         gopFrames: z.ZodOptional<z.ZodNumber>;
         bf: z.ZodOptional<z.ZodNumber>;
         preset: z.ZodOptional<z.ZodEnum<{
-            fast: "fast";
             ultrafast: "ultrafast";
             superfast: "superfast";
             veryfast: "veryfast";
             faster: "faster";
+            fast: "fast";
             medium: "medium";
         }>>;
         tune: z.ZodOptional<z.ZodEnum<{

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

@@ -3445,6 +3445,13 @@ export type AppRouter = TrpcCoreRouter<{
             output: z.infer<typeof llmCapability.methods.listNodeModels.output>;
             meta: object;
         }>;
+        resolveModelRef: TRPCMutationProcedure<{
+            input: {
+                [x: string]: unknown;
+            } & z.input<typeof llmCapability.methods.resolveModelRef.input>;
+            output: z.infer<typeof llmCapability.methods.resolveModelRef.output>;
+            meta: object;
+        }>;
         installModel: TRPCMutationProcedure<{
             input: {
                 [x: string]: unknown;
@@ -8801,14 +8808,14 @@ export type AppRouter = TrpcCoreRouter<{
     }, import("@trpc/server").TRPCDecorateCreateRouterOptions<{
         listCapabilities: import("@trpc/server").TRPCQueryProcedure<{
             input: void;
-            output: import("packages/types/dist").CapabilityInfo[];
+            output: import("@camstack/types").CapabilityInfo[];
             meta: object;
         }>;
         getCapability: import("@trpc/server").TRPCQueryProcedure<{
             input: {
                 name: string;
             };
-            output: import("packages/types/dist").CapabilityInfo | null;
+            output: import("@camstack/types").CapabilityInfo | null;
             meta: object;
         }>;
         setActiveSingleton: import("@trpc/server").TRPCMutationProcedure<{
@@ -8880,14 +8887,14 @@ export type AppRouter = TrpcCoreRouter<{
     }>> & import("@trpc/server").TRPCDecorateCreateRouterOptions<{
         listCapabilities: import("@trpc/server").TRPCQueryProcedure<{
             input: void;
-            output: import("packages/types/dist").CapabilityInfo[];
+            output: import("@camstack/types").CapabilityInfo[];
             meta: object;
         }>;
         getCapability: import("@trpc/server").TRPCQueryProcedure<{
             input: {
                 name: string;
             };
-            output: import("packages/types/dist").CapabilityInfo | null;
+            output: import("@camstack/types").CapabilityInfo | null;
             meta: object;
         }>;
         setActiveSingleton: import("@trpc/server").TRPCMutationProcedure<{
@@ -9124,14 +9131,14 @@ export type AppRouter = TrpcCoreRouter<{
                 category?: string | undefined;
                 limit?: number | undefined;
             } | undefined;
-            output: readonly import("packages/types/dist").SystemEvent[];
+            output: readonly import("@camstack/types").SystemEvent[];
             meta: object;
         }>;
         onEvent: import("@trpc/server").TRPCSubscriptionProcedure<{
             input: {
                 category?: string | undefined;
             };
-            output: AsyncIterable<import("packages/types/dist").SystemEvent, any, any>;
+            output: AsyncIterable<import("@camstack/types").SystemEvent, any, any>;
             meta: object;
         }>;
         onDeviceEvent: import("@trpc/server").TRPCSubscriptionProcedure<{
@@ -9147,14 +9154,14 @@ export type AppRouter = TrpcCoreRouter<{
                 category?: string | undefined;
                 limit?: number | undefined;
             } | undefined;
-            output: readonly import("packages/types/dist").SystemEvent[];
+            output: readonly import("@camstack/types").SystemEvent[];
             meta: object;
         }>;
         onEvent: import("@trpc/server").TRPCSubscriptionProcedure<{
             input: {
                 category?: string | undefined;
             };
-            output: AsyncIterable<import("packages/types/dist").SystemEvent, any, any>;
+            output: AsyncIterable<import("@camstack/types").SystemEvent, any, any>;
             meta: object;
         }>;
         onDeviceEvent: import("@trpc/server").TRPCSubscriptionProcedure<{

package/dist/generated/device-local-state.d.ts

@@ -49,6 +49,7 @@ import { ptzAutotrackCapability } from '../capabilities/ptz-autotrack.cap.js';
 import { sceneMonitorCapability } from '../capabilities/scene-monitor.cap.js';
 import { scriptRunnerCapability } from '../capabilities/script-runner.cap.js';
 import { smokeCapability } from '../capabilities/smoke.cap.js';
+import { streamCatalogCapability } from '../capabilities/stream-catalog.cap.js';
 import { streamParamsCapability } from '../capabilities/stream-params.cap.js';
 import { switchCapability } from '../capabilities/switch.cap.js';
 import { tamperCapability } from '../capabilities/tamper.cap.js';
@@ -124,6 +125,7 @@ export interface DeviceLocalState {
     sceneMonitor: InferRuntimeState<typeof sceneMonitorCapability>;
     scriptRunner: InferRuntimeState<typeof scriptRunnerCapability>;
     smoke: InferRuntimeState<typeof smokeCapability>;
+    streamCatalog: InferRuntimeState<typeof streamCatalogCapability>;
     streamParams: InferRuntimeState<typeof streamParamsCapability>;
     switch: InferRuntimeState<typeof switchCapability>;
     tamper: InferRuntimeState<typeof tamperCapability>;
@@ -209,6 +211,7 @@ export interface CapNameToRuntimeStateMap {
     'scene-monitor': InferRuntimeState<typeof sceneMonitorCapability>;
     'script-runner': InferRuntimeState<typeof scriptRunnerCapability>;
     'smoke': InferRuntimeState<typeof smokeCapability>;
+    'stream-catalog': InferRuntimeState<typeof streamCatalogCapability>;
     'stream-params': InferRuntimeState<typeof streamParamsCapability>;
     'switch': InferRuntimeState<typeof switchCapability>;
     'tamper': InferRuntimeState<typeof tamperCapability>;

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

@@ -154,6 +154,7 @@ export interface DeviceProxyState {
     readonly sceneMonitor: SliceHandle<InferRuntimeState<typeof sceneMonitorCapability>>;
     readonly scriptRunner: SliceHandle<InferRuntimeState<typeof scriptRunnerCapability>>;
     readonly smoke: SliceHandle<InferRuntimeState<typeof smokeCapability>>;
+    readonly streamCatalog: SliceHandle<InferRuntimeState<typeof streamCatalogCapability>>;
     readonly streamParams: SliceHandle<InferRuntimeState<typeof streamParamsCapability>>;
     readonly switch: SliceHandle<InferRuntimeState<typeof switchCapability>>;
     readonly tamper: SliceHandle<InferRuntimeState<typeof tamperCapability>>;

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

package/dist/generated/runtime-state-durability.d.ts

@@ -11,7 +11,7 @@ export interface RuntimeStatePolicy {
 }
 /**
  * Per-cap runtime-state policy, projected from every `*.cap.ts` that declares
- * `runtimeState`. 63 caps: 33 `restored`, 30 `session`.
+ * `runtimeState`. 64 caps: 34 `restored`, 30 `session`.
  *
  * A cap absent from this map has no runtime-state slice at all. A cap PRESENT
  * with `durability: 'session'` has one and has decided not to keep it.

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

@@ -73,7 +73,7 @@ export interface SystemProxy {
     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 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' | 'installModel' | 'deleteModel' | 'getRuntimeStatus' | 'startRuntime' | 'stopRuntime'>;
+    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' | 'getAllowedAddresses' | 'setAllowedAddresses' | 'resetAllowlistToBestMatch'>;
     readonly meshNetwork: Pick<InferProvider<typeof meshNetworkCapability>, 'getStatus' | 'join' | 'startLogin' | 'leave' | 'logout' | 'listPeers' | 'testConnection'>;
     readonly metricsProvider: Pick<InferProvider<typeof metricsProviderCapability>, 'collectSnapshot' | 'getCached' | 'getCurrent' | 'getDiskSpace' | 'getGpuInfo' | 'getCpuTemperature' | 'getProcessStats' | 'listAddonInstances' | 'getAddonStats' | 'listNodeProcesses' | 'killProcess' | 'dumpHeapSnapshot'>;

package/dist/index.d.ts

@@ -147,6 +147,8 @@ export { DeviceRuntimeState } from './device/device-runtime-state.js';
 export type { SliceHandle, SliceHandleApi, SliceHandleSource, } from './device/device-state-handle.js';
 export { createLazyTrpcSource, createMirrorSource, createSliceHandle, } from './device/device-state-handle.js';
 export { ChargingStatus, DeviceFeature, DeviceRole, DeviceType } from './device/device-type.js';
+export type { BatteryPresence, BatteryPresenceInput } from './device/battery-presence.js';
+export { BATTERY_UNREACHABLE_AFTER_MS, deriveBatteryPresence, isBatteryPresenceFault, } from './device/battery-presence.js';
 export type { IBatteryOperated, IDoorbellButton, INativeSnapshot, IPanTiltZoom, IRebootable, ITwoWayAudio, } from './device/features.js';
 export { getByPath, setByPath } from './device/path-util.js';
 export type { ReachabilityPollHandle, ReachabilityPollLogger, ReachabilityPollOptions, } from './device/reachability-poll.js';
@@ -203,6 +205,7 @@ export { type DeviceMetaLike, type DeviceReachSummary, deviceSelectorMatches, ty
 export type { CameraDetectionCapabilities, CameraMotionConfig, CameraNativeDetectionConfig, } from './types/camera-detection.js';
 export { DEVICE_TYPE_INFO, type DeviceTypeInfo } from './types/device-type.js';
 export * from './units/index.js';
+export { BOOT_RECOVERY_BACKOFF_MS } from './util/boot-recovery-backoff.js';
 export { bestLocationMatch, locationSimilarity } from './util/location-match.js';
 export { bareAddonId, isSameAddonId } from './utils/addon-id.js';
 export { cosineSimilarity } from './utils/cosine-similarity.js';