@camstack/types 1.1.48 → 1.1.50

package/dist/addon.js

@@ -1,6 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_sleep = require("./sleep-BoTIF1d4.js");
-const require_event_category = require("./event-category-AkBNxg_X.js");
+const require_sleep = require("./sleep-CF-UWPp0.js");
+const require_event_category = require("./event-category-CGj9fI4L.js");
 const require_err_msg = require("./err-msg-COpsHMw2.js");
 exports.BaseAddon = require_sleep.BaseAddon;
 exports.DATAPLANE_SECRET_HEADER = require_sleep.DATAPLANE_SECRET_HEADER;

package/dist/addon.mjs

@@ -1,4 +1,4 @@
-import { A as parseJsonUnknown, D as asString, I as scopeKey, M as ReadinessRegistry, N as ReadinessTimeoutError, S as DeviceType, T as asJsonObject, a as viewerUiCapability, bt as DisposerChain, ct as BaseAddon, ft as emitReadiness, i as deviceOpsCapability, j as DATAPLANE_SECRET_HEADER, lt as normalizeAddonInitResult, m as expandCapMethods, o as adminUiCapability, s as createDeviceProxy, t as sleep } from "./sleep-B3OHhFkL.mjs";
-import { t as EventCategory } from "./event-category-H4AVePnn.mjs";
+import { A as parseJsonUnknown, D as asString, I as scopeKey, M as ReadinessRegistry, N as ReadinessTimeoutError, S as DeviceType, T as asJsonObject, a as viewerUiCapability, bt as DisposerChain, ct as BaseAddon, ft as emitReadiness, i as deviceOpsCapability, j as DATAPLANE_SECRET_HEADER, lt as normalizeAddonInitResult, m as expandCapMethods, o as adminUiCapability, s as createDeviceProxy, t as sleep } from "./sleep-D8ZkNoYz.mjs";
+import { t as EventCategory } from "./event-category-D4HJq7Mw.mjs";
 import { t as errMsg } from "./err-msg-IQTHeDzc.mjs";
 export { BaseAddon, DATAPLANE_SECRET_HEADER, DeviceType, DisposerChain, EventCategory, ReadinessRegistry, ReadinessTimeoutError, adminUiCapability, asJsonObject, asString, createDeviceProxy, deviceOpsCapability, emitReadiness, errMsg, expandCapMethods, normalizeAddonInitResult, parseJsonUnknown, scopeKey, sleep, viewerUiCapability };

package/dist/capabilities/index.d.ts

@@ -77,7 +77,7 @@ export { type ILlmProvider, type LlmDefault, type LlmDefaultSelector, LlmDefault
 export { type ILlmRuntimeProvider, llmRuntimeCapability, type LlmNodeModel, LlmNodeModelSchema, type LlmRuntimeCompleteInput, LlmRuntimeCompleteInputSchema, type LlmRuntimeDiskUsage, LlmRuntimeDiskUsageSchema, type LlmRuntimeStatus, LlmRuntimeStatusSchema, type ManagedModelRef, ManagedModelRefSchema, type ManagedRuntimeConfig, ManagedRuntimeConfigSchema, } from './llm-runtime.cap.js';
 export { type LlmErrorCode, LlmErrorCodeSchema, type LlmGenerateBaseInput, LlmGenerateBaseInputSchema, type LlmGenerateErr, LlmGenerateErrSchema, type LlmGenerateOk, LlmGenerateOkSchema, type LlmGenerateResult, LlmGenerateResultSchema, type LlmImage, LlmImageSchema, type LlmUsage, LlmUsageSchema, } from './llm-shared.js';
 export { type IOauthIntegrationProvider, type OauthIntegrationDescriptor, OauthIntegrationDescriptorSchema, oauthIntegrationCapability, } from './oauth-integration.cap.js';
-export { type AudioEvent, AudioEventSchema, type DetectionSource, DetectionSourceSchema, type EventKind, type EventKindCategory, EventKindCategorySchema, type EventKindDescriptor, EventKindDescriptorSchema, type EventKindIcon, EventKindIconSchema, EventKindSchema, type IPipelineAnalyticsProvider, type KeyEvent, KeyEventSchema, type MediaFile, type MediaFileKind, MediaFileSchema, type MotionEvent, MotionEventSchema, type ObjectEvent, ObjectEventSchema, pipelineAnalyticsCapability, type RecentTracksPage, RecentTracksPageSchema, type RecentTracksQuery, RecentTracksQueryInput, type ScoredObjectEvent, ScoredObjectEventSchema, type SensorEvent, SensorEventSchema, type Track, type TrackCascadeCounts, TrackCascadeCountsSchema, TrackedDetectionSchema, type TrackEnvelope, TrackEnvelopeSchema, type TrackProjection, TrackProjectionSchema, TrackSchema, type TrackState, TrackStateSchema, type TrackZoneFilter, TrackZoneFilterSchema, } from './pipeline-analytics.cap.js';
+export { type AudioEvent, AudioEventSchema, type DetectionSource, DetectionSourceSchema, type EventKind, type EventKindCategory, EventKindCategorySchema, type EventKindDescriptor, EventKindDescriptorSchema, type EventKindIcon, EventKindIconSchema, EventKindSchema, type EventPruneCounts, type EventStoreDeviceFootprint, type EventStoreFootprint, type IPipelineAnalyticsProvider, type KeyEvent, KeyEventSchema, type MediaFile, type MediaFileKind, MediaFileSchema, type MotionEvent, MotionEventSchema, type ObjectEvent, ObjectEventSchema, pipelineAnalyticsCapability, type RecentTracksPage, RecentTracksPageSchema, type RecentTracksQuery, RecentTracksQueryInput, type ScoredObjectEvent, ScoredObjectEventSchema, type SensorEvent, SensorEventSchema, type Track, type TrackCascadeCounts, TrackCascadeCountsSchema, TrackedDetectionSchema, type TrackEnvelope, TrackEnvelopeSchema, type TrackProjection, TrackProjectionSchema, TrackSchema, type TrackState, TrackStateSchema, type TrackZoneFilter, TrackZoneFilterSchema, } from './pipeline-analytics.cap.js';
 export { EVENT_KIND_BY_CAP, type SensorEventKindDescriptor } from './sensor-event-kinds.js';
 export type { PipelineStepInputOutput, PipelineValidationIssue, PipelineValidationResult, } from './pipeline-executor.cap.js';
 export { ModelSubstitutionSchema, PipelineDefaultStepSchema, PipelineEngineChoiceSchema, PipelineRunResultBridge, PipelineStepInputSchema, PipelineValidationIssueSchema, PipelineValidationResultSchema, pipelineExecutorCapability, } from './pipeline-executor.cap.js';
@@ -173,6 +173,7 @@ export { type IPtzProvider, PtzMoveCommandSchema, type PtzOptions, PtzPositionSc
 export { type IPtzAutotrackProvider, type PtzAutotrackRuntimeState, PtzAutotrackRuntimeStateSchema, type PtzAutotrackSettings, PtzAutotrackSettingsSchema, type PtzAutotrackStatus, PtzAutotrackStatusSchema, type PtzAutotrackTargetOption, PtzAutotrackTargetOptionSchema, ptzAutotrackCapability, } from './ptz-autotrack.cap.js';
 export { type IRebootProvider, rebootCapability } from './reboot.cap.js';
 export { type IRecordingProvider, type LocateSegmentResult, LocateSegmentResultSchema, type ReadSegmentBytesResult, ReadSegmentBytesResultSchema, type RecordingAvailability, RecordingAvailabilitySchema, type RecordingDays, RecordingDaysSchema, type RecordingDeviceUsage, RecordingDeviceUsageSchema, type RecordingLocationUsage, RecordingLocationUsageSchema, type RecordingManifest, RecordingManifestSchema, RecordingRangeSchema, type RecordingStatus, RecordingStatusSchema, type RecordingStorageUsage, RecordingStorageUsageSchema, recordingCapability, } from './recording.cap.js';
+export { type ExportDownload, ExportDownloadSchema, type ExportOptions, ExportOptionsSchema, type ExportRecord, ExportRecordSchema, type ExportState, ExportStateSchema, ExportSpeedSchema, ExportTimelapseSchema, type IRecordingExportProvider, recordingExportCapability, } from './recording-export.cap.js';
 export { type ZoneRule, type ZoneRuleMode, ZoneRuleModeEnum, ZoneRuleSchema, type ZoneRules, ZoneRulesArraySchema, } from './schemas/zone-rule.js';
 export { type IScriptRunnerProvider, type ScriptRunnerStatus, ScriptRunnerStatusSchema, scriptRunnerCapability, } from './script-runner.cap.js';
 export { type ISmokeProvider, type SmokeStatus, SmokeStatusSchema, smokeCapability, } from './smoke.cap.js';
@@ -292,6 +293,7 @@ import type { ptzCapability } from './ptz.cap.js';
 import type { ptzAutotrackCapability } from './ptz-autotrack.cap.js';
 import type { rebootCapability } from './reboot.cap.js';
 import type { recordingCapability } from './recording.cap.js';
+import type { recordingExportCapability } from './recording-export.cap.js';
 import type { scriptRunnerCapability } from './script-runner.cap.js';
 import type { serverManagementCapability } from './server-management.cap.js';
 import type { settingsStoreCapability } from './settings-store.cap.js';
@@ -321,6 +323,6 @@ import type { webrtcSessionCapability } from './webrtc-session.cap.js';
 import type { zoneAnalyticsCapability } from './zone-analytics.cap.js';
 import type { zoneRulesCapability } from './zone-rules.cap.js';
 import type { zonesCapability } from './zones.cap.js';
-type AnyCapability = typeof addonSettingsCapability | typeof alertsCapability | typeof storageCapability | typeof storageProviderCapability | typeof storageEvictableCapability | typeof filesystemBrowseCapability | typeof backupCapability | typeof settingsStoreCapability | typeof logDestinationCapability | typeof adminUiCapability | typeof viewerUiCapability | typeof ssoBridgeCapability | typeof userPasskeysCapability | typeof smtpProviderCapability | typeof mqttBrokerCapability | typeof brokerCapability | typeof deviceAdoptionCapability | typeof deviceExportCapability | typeof addonPagesCapability | typeof addonPagesSourceCapability | typeof addonWidgetsCapability | typeof addonWidgetsSourceCapability | typeof customModelRegistryCapability | typeof modelDistributorCapability | typeof modelConvertCapability | typeof addonRoutesCapability | typeof streamBrokerCapability | typeof decoderCapability | typeof webrtcSessionCapability | typeof cameraStreamsCapability | typeof motionDetectionCapability | typeof pipelineExecutorCapability | typeof detectionPipelineCapability | typeof cameraPipelineConfigCapability | typeof pipelineRunnerCapability | typeof pipelineOrchestratorCapability | typeof audioAnalyzerCapability | typeof audioAnalysisCapability | typeof audioCodecCapability | typeof embeddingEncoderCapability | typeof deviceProviderCapability | typeof deviceManagerCapability | typeof deviceStateCapability | typeof authProviderCapability | typeof loginMethodCapability | typeof networkAccessCapability | typeof turnProviderCapability | typeof snapshotCapability | typeof llmCapability | typeof llmRuntimeCapability | typeof notificationOutputCapability | typeof advancedNotifierCapability | typeof pipelineAnalyticsCapability | typeof metricsProviderCapability | typeof ptzCapability | typeof ptzAutotrackCapability | typeof consumablesCapability | typeof rebootCapability | typeof deviceDiscoveryCapability | typeof brightnessCapability | typeof colorCapability | typeof climateControlCapability | typeof coverCapability | typeof valveCapability | typeof humidifierCapability | typeof waterHeaterCapability | typeof weatherCapability | typeof imageCapability | typeof lockControlCapability | typeof vacuumControlCapability | typeof petFeederCapability | typeof lawnMowerControlCapability | typeof fanControlCapability | typeof controlCapability | typeof notifierCapability | typeof mediaPlayerCapability | typeof alarmPanelCapability | typeof presenceCapability | typeof scriptRunnerCapability | typeof automationControlCapability | typeof motionTriggerCapability | typeof eventsCapability | typeof zonesCapability | typeof zoneRulesCapability | typeof zoneAnalyticsCapability | typeof audioMetricsCapability | typeof motionCapability | typeof contactCapability | typeof floodCapability | typeof smokeCapability | typeof carbonMonoxideCapability | typeof gasCapability | typeof tamperCapability | typeof vibrationCapability | typeof connectivityCapability | typeof binaryCapability | typeof temperatureSensorCapability | typeof humiditySensorCapability | typeof ambientLightSensorCapability | typeof pressureSensorCapability | typeof powerMeterCapability | typeof airQualitySensorCapability | typeof numericSensorCapability | typeof enumSensorCapability | typeof recordingCapability | typeof deviceOpsCapability | typeof platformProbeCapability | typeof localNetworkCapability | typeof meshNetworkCapability | typeof userManagementCapability | typeof systemCapability | typeof networkQualityCapability | typeof toastCapability | typeof nodesCapability | typeof serverManagementCapability | typeof integrationsCapability | typeof addonsCapability | typeof oauthIntegrationCapability | typeof streamParamsCapability | typeof streamCatalogCapability | typeof motionZonesCapability | typeof sceneMonitorCapability | typeof privacyMaskCapability | typeof dayNightCapability | typeof imageSettingsCapability;
+type AnyCapability = typeof addonSettingsCapability | typeof alertsCapability | typeof storageCapability | typeof storageProviderCapability | typeof storageEvictableCapability | typeof filesystemBrowseCapability | typeof backupCapability | typeof settingsStoreCapability | typeof logDestinationCapability | typeof adminUiCapability | typeof viewerUiCapability | typeof ssoBridgeCapability | typeof userPasskeysCapability | typeof smtpProviderCapability | typeof mqttBrokerCapability | typeof brokerCapability | typeof deviceAdoptionCapability | typeof deviceExportCapability | typeof addonPagesCapability | typeof addonPagesSourceCapability | typeof addonWidgetsCapability | typeof addonWidgetsSourceCapability | typeof customModelRegistryCapability | typeof modelDistributorCapability | typeof modelConvertCapability | typeof addonRoutesCapability | typeof streamBrokerCapability | typeof decoderCapability | typeof webrtcSessionCapability | typeof cameraStreamsCapability | typeof motionDetectionCapability | typeof pipelineExecutorCapability | typeof detectionPipelineCapability | typeof cameraPipelineConfigCapability | typeof pipelineRunnerCapability | typeof pipelineOrchestratorCapability | typeof audioAnalyzerCapability | typeof audioAnalysisCapability | typeof audioCodecCapability | typeof embeddingEncoderCapability | typeof deviceProviderCapability | typeof deviceManagerCapability | typeof deviceStateCapability | typeof authProviderCapability | typeof loginMethodCapability | typeof networkAccessCapability | typeof turnProviderCapability | typeof snapshotCapability | typeof llmCapability | typeof llmRuntimeCapability | typeof notificationOutputCapability | typeof advancedNotifierCapability | typeof pipelineAnalyticsCapability | typeof metricsProviderCapability | typeof ptzCapability | typeof ptzAutotrackCapability | typeof consumablesCapability | typeof rebootCapability | typeof deviceDiscoveryCapability | typeof brightnessCapability | typeof colorCapability | typeof climateControlCapability | typeof coverCapability | typeof valveCapability | typeof humidifierCapability | typeof waterHeaterCapability | typeof weatherCapability | typeof imageCapability | typeof lockControlCapability | typeof vacuumControlCapability | typeof petFeederCapability | typeof lawnMowerControlCapability | typeof fanControlCapability | typeof controlCapability | typeof notifierCapability | typeof mediaPlayerCapability | typeof alarmPanelCapability | typeof presenceCapability | typeof scriptRunnerCapability | typeof automationControlCapability | typeof motionTriggerCapability | typeof eventsCapability | typeof zonesCapability | typeof zoneRulesCapability | typeof zoneAnalyticsCapability | typeof audioMetricsCapability | typeof motionCapability | typeof contactCapability | typeof floodCapability | typeof smokeCapability | typeof carbonMonoxideCapability | typeof gasCapability | typeof tamperCapability | typeof vibrationCapability | typeof connectivityCapability | typeof binaryCapability | typeof temperatureSensorCapability | typeof humiditySensorCapability | typeof ambientLightSensorCapability | typeof pressureSensorCapability | typeof powerMeterCapability | typeof airQualitySensorCapability | typeof numericSensorCapability | typeof enumSensorCapability | typeof recordingCapability | typeof recordingExportCapability | typeof deviceOpsCapability | typeof platformProbeCapability | typeof localNetworkCapability | typeof meshNetworkCapability | typeof userManagementCapability | typeof systemCapability | typeof networkQualityCapability | typeof toastCapability | typeof nodesCapability | typeof serverManagementCapability | typeof integrationsCapability | typeof addonsCapability | typeof oauthIntegrationCapability | typeof streamParamsCapability | typeof streamCatalogCapability | typeof motionZonesCapability | typeof sceneMonitorCapability | typeof privacyMaskCapability | typeof dayNightCapability | typeof imageSettingsCapability;
 export type CapabilityName = AnyCapability['name'];
 export type ITypedReadinessRegistry = IReadinessRegistry<CapabilityName>;

package/dist/capabilities/pipeline-analytics.cap.d.ts

@@ -67,6 +67,7 @@ export declare const EventKindIconSchema: z.ZodEnum<{
     vehicle: "vehicle";
     animal: "animal";
     motion: "motion";
+    package: "package";
     door: "door";
     pir: "pir";
     smoke: "smoke";
@@ -78,6 +79,7 @@ export declare const EventKindCategorySchema: z.ZodEnum<{
     audio: "audio";
     custom: "custom";
     motion: "motion";
+    package: "package";
     detection: "detection";
 }>;
 export type EventKindCategory = z.infer<typeof EventKindCategorySchema>;
@@ -93,6 +95,7 @@ declare const EventKindDescriptorSchema: z.ZodObject<{
         vehicle: "vehicle";
         animal: "animal";
         motion: "motion";
+        package: "package";
         door: "door";
         pir: "pir";
         smoke: "smoke";
@@ -103,6 +106,7 @@ declare const EventKindDescriptorSchema: z.ZodObject<{
         audio: "audio";
         custom: "custom";
         motion: "motion";
+        package: "package";
         detection: "detection";
     }>;
     source: z.ZodObject<{
@@ -496,6 +500,31 @@ declare const TrackCascadeCountsSchema: z.ZodObject<{
     embeddings: z.ZodNumber;
 }, z.core.$strip>;
 export type TrackCascadeCounts = z.infer<typeof TrackCascadeCountsSchema>;
+/** Event-store footprint for one camera. */
+declare const EventStoreDeviceFootprintSchema: z.ZodObject<{
+    deviceId: z.ZodNumber;
+    rows: z.ZodNumber;
+    bytes: z.ZodNumber;
+}, z.core.$strip>;
+export type EventStoreDeviceFootprint = z.infer<typeof EventStoreDeviceFootprintSchema>;
+/** Aggregate event-store footprint: global totals + per-camera breakdown. */
+declare const EventStoreFootprintSchema: z.ZodObject<{
+    totalRows: z.ZodNumber;
+    totalBytes: z.ZodNumber;
+    devices: z.ZodReadonly<z.ZodArray<z.ZodObject<{
+        deviceId: z.ZodNumber;
+        rows: z.ZodNumber;
+        bytes: z.ZodNumber;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+export type EventStoreFootprint = z.infer<typeof EventStoreFootprintSchema>;
+/** Per-kind counts returned by the event-prune / device-delete mutations. */
+declare const EventPruneCountsSchema: z.ZodObject<{
+    motion: z.ZodNumber;
+    object: z.ZodNumber;
+    audio: z.ZodNumber;
+}, z.core.$strip>;
+export type EventPruneCounts = z.infer<typeof EventPruneCountsSchema>;
 export declare const pipelineAnalyticsCapability: {
     readonly name: "pipeline-analytics";
     readonly scope: "device";
@@ -922,6 +951,7 @@ export declare const pipelineAnalyticsCapability: {
                 vehicle: "vehicle";
                 animal: "animal";
                 motion: "motion";
+                package: "package";
                 door: "door";
                 pir: "pir";
                 smoke: "smoke";
@@ -932,6 +962,7 @@ export declare const pipelineAnalyticsCapability: {
                 audio: "audio";
                 custom: "custom";
                 motion: "motion";
+                package: "package";
                 detection: "detection";
             }>;
             source: z.ZodObject<{
@@ -1071,6 +1102,84 @@ export declare const pipelineAnalyticsCapability: {
             deleted: z.ZodNumber;
             failed: z.ZodReadonly<z.ZodArray<z.ZodString>>;
         }, z.core.$strip>, "mutation">;
+        /**
+         * Durable event-store footprint for the management UI: event rows
+         * (motion + object + audio) counted per camera + total, plus the
+         * event-owned media bytes on disk per camera + total. Stat/count-based,
+         * computed on demand.
+         */
+        readonly getEventStoreFootprint: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{}, z.core.$strip>, z.ZodObject<{
+            totalRows: z.ZodNumber;
+            totalBytes: z.ZodNumber;
+            devices: z.ZodReadonly<z.ZodArray<z.ZodObject<{
+                deviceId: z.ZodNumber;
+                rows: z.ZodNumber;
+                bytes: z.ZodNumber;
+            }, z.core.$strip>>>;
+        }, z.core.$strip>, "query">;
+        /**
+         * Cluster-wide prune of events older than `olderThanMs` (exclusive) across
+         * every camera, deleting each event's media in lockstep. Logged to the
+         * events ops-log with `reason` (default `'retention'`). Returns the summed
+         * per-kind deleted counts.
+         */
+        readonly pruneEvents: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
+            olderThanMs: z.ZodNumber;
+            reason: z.ZodOptional<z.ZodEnum<{
+                manual: "manual";
+                retention: "retention";
+                quota: "quota";
+                operator: "operator";
+            }>>;
+        }, z.core.$strip>, z.ZodObject<{
+            motion: z.ZodNumber;
+            object: z.ZodNumber;
+            audio: z.ZodNumber;
+        }, z.core.$strip>, "mutation">;
+        /**
+         * Manually delete EVERY event (motion + object + audio) for one camera and
+         * its event-owned media in lockstep. Logged to the events ops-log as
+         * `op:'manual-delete', reason:'manual'`. Destructive — the admin UI guards
+         * it behind a confirm.
+         */
+        readonly deleteDeviceEvents: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
+            deviceId: z.ZodNumber;
+        }, z.core.$strip>, z.ZodObject<{
+            motion: z.ZodNumber;
+            object: z.ZodNumber;
+            audio: z.ZodNumber;
+        }, z.core.$strip>, "mutation">;
+        /** The events ops-log rows (newest-first), optionally scoped to one camera.
+         *  Backed by a declared pipeline-analytics SQLite collection. */
+        readonly listOpsLog: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
+            deviceId: z.ZodOptional<z.ZodNumber>;
+            limit: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>, z.ZodReadonly<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            at: z.ZodNumber;
+            domain: z.ZodEnum<{
+                events: "events";
+                recording: "recording";
+            }>;
+            op: z.ZodEnum<{
+                prune: "prune";
+                "manual-delete": "manual-delete";
+                rescan: "rescan";
+                "retention-run": "retention-run";
+            }>;
+            reason: z.ZodEnum<{
+                manual: "manual";
+                retention: "retention";
+                quota: "quota";
+                operator: "operator";
+            }>;
+            deviceId: z.ZodNullable<z.ZodNumber>;
+            nodeId: z.ZodString;
+            itemsAffected: z.ZodNumber;
+            bytesReclaimed: z.ZodNumber;
+            detail: z.ZodNullable<z.ZodString>;
+            actor: z.ZodString;
+        }, z.core.$strip>>>, "query">;
         readonly getEventMedia: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
             eventId: z.ZodString;
             kind: z.ZodOptional<z.ZodEnum<{

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

@@ -0,0 +1,305 @@
+/**
+ * `recordingExport` cap — render a footage time range into a single downloadable
+ * MP4 (regular / accelerated / decelerated / timelapse, ± audio), kept for a
+ * bounded lifetime with a durable history, auto-expiry, and optional
+ * delete-after-download.
+ *
+ * Like `recording` this is a `scope:'system', mode:'singleton'` cap: the
+ * recorder self-gates so exactly ONE node (the designated `recordingNodeId`,
+ * default `hub`) registers it. Device-scoped methods carry `deviceId` in their
+ * input and dispatch to that single provider; the render runs on the node that
+ * owns the footage (no cross-node segment transfer). Download rides the
+ * framework addon data-plane. State persists in a DurableState blob (NOT
+ * SQLite); history rows survive file deletion for audit.
+ */
+import { z } from 'zod';
+import { type InferProvider } from './capability-definition.js';
+/** Playback-speed multiplier for the render (1 = realtime). */
+export declare const ExportSpeedSchema: z.ZodNumber;
+/** Timelapse cadence — sample one source frame per `everyMs`, output at `outputFps`. */
+export declare const ExportTimelapseSchema: z.ZodObject<{
+    everyMs: z.ZodNumber;
+    outputFps: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+/**
+ * Render options. `speed` and `timelapse` are mutually exclusive. `includeAudio`
+ * is honoured only for a realtime-ish speed (0.5–2×); timelapse is always
+ * silent. `maxLifeMs` bounds how long the finished file is kept;
+ * `deleteAfterDownload` removes it shortly after the first complete download.
+ */
+export declare const ExportOptionsSchema: z.ZodObject<{
+    speed: z.ZodOptional<z.ZodNumber>;
+    timelapse: z.ZodOptional<z.ZodObject<{
+        everyMs: z.ZodNumber;
+        outputFps: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+    includeAudio: z.ZodBoolean;
+    maxLifeMs: z.ZodNumber;
+    deleteAfterDownload: z.ZodBoolean;
+    title: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type ExportOptions = z.infer<typeof ExportOptionsSchema>;
+export declare const ExportStateSchema: z.ZodEnum<{
+    ready: "ready";
+    failed: "failed";
+    queued: "queued";
+    deleted: "deleted";
+    rendering: "rendering";
+    expired: "expired";
+}>;
+export type ExportState = z.infer<typeof ExportStateSchema>;
+/** One export job / history row. */
+export declare const ExportRecordSchema: z.ZodObject<{
+    id: z.ZodString;
+    deviceId: z.ZodNumber;
+    profile: z.ZodString;
+    fromMs: z.ZodNumber;
+    toMs: z.ZodNumber;
+    options: z.ZodObject<{
+        speed: z.ZodOptional<z.ZodNumber>;
+        timelapse: z.ZodOptional<z.ZodObject<{
+            everyMs: z.ZodNumber;
+            outputFps: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>>;
+        includeAudio: z.ZodBoolean;
+        maxLifeMs: z.ZodNumber;
+        deleteAfterDownload: z.ZodBoolean;
+        title: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    state: z.ZodEnum<{
+        ready: "ready";
+        failed: "failed";
+        queued: "queued";
+        deleted: "deleted";
+        rendering: "rendering";
+        expired: "expired";
+    }>;
+    progressPct: z.ZodNullable<z.ZodNumber>;
+    fileBytes: z.ZodNullable<z.ZodNumber>;
+    expiresAt: z.ZodNumber;
+    deleteAfterDownload: z.ZodBoolean;
+    downloadedAt: z.ZodNullable<z.ZodNumber>;
+    createdAt: z.ZodNumber;
+    createdBy: z.ZodString;
+    error: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+export type ExportRecord = z.infer<typeof ExportRecordSchema>;
+/** Candidate download URLs (LAN first, then operator extra hosts). */
+export declare const ExportDownloadSchema: z.ZodObject<{
+    url: z.ZodString;
+    endpoints: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;
+export type ExportDownload = z.infer<typeof ExportDownloadSchema>;
+export declare const recordingExportCapability: {
+    readonly name: "recordingExport";
+    readonly scope: "system";
+    readonly mode: "singleton";
+    readonly methods: {
+        /** Queue a render of `[fromMs,toMs)` for `deviceId`/`profile`. Fails fast
+         *  when no footage covers the range. Returns the queued record. */
+        readonly createExport: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
+            deviceId: z.ZodNumber;
+            profile: z.ZodString;
+            fromMs: z.ZodNumber;
+            toMs: z.ZodNumber;
+            options: z.ZodObject<{
+                speed: z.ZodOptional<z.ZodNumber>;
+                timelapse: z.ZodOptional<z.ZodObject<{
+                    everyMs: z.ZodNumber;
+                    outputFps: z.ZodOptional<z.ZodNumber>;
+                }, z.core.$strip>>;
+                includeAudio: z.ZodBoolean;
+                maxLifeMs: z.ZodNumber;
+                deleteAfterDownload: z.ZodBoolean;
+                title: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>;
+        }, z.core.$strip>, z.ZodObject<{
+            id: z.ZodString;
+            deviceId: z.ZodNumber;
+            profile: z.ZodString;
+            fromMs: z.ZodNumber;
+            toMs: z.ZodNumber;
+            options: z.ZodObject<{
+                speed: z.ZodOptional<z.ZodNumber>;
+                timelapse: z.ZodOptional<z.ZodObject<{
+                    everyMs: z.ZodNumber;
+                    outputFps: z.ZodOptional<z.ZodNumber>;
+                }, z.core.$strip>>;
+                includeAudio: z.ZodBoolean;
+                maxLifeMs: z.ZodNumber;
+                deleteAfterDownload: z.ZodBoolean;
+                title: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>;
+            state: z.ZodEnum<{
+                ready: "ready";
+                failed: "failed";
+                queued: "queued";
+                deleted: "deleted";
+                rendering: "rendering";
+                expired: "expired";
+            }>;
+            progressPct: z.ZodNullable<z.ZodNumber>;
+            fileBytes: z.ZodNullable<z.ZodNumber>;
+            expiresAt: z.ZodNumber;
+            deleteAfterDownload: z.ZodBoolean;
+            downloadedAt: z.ZodNullable<z.ZodNumber>;
+            createdAt: z.ZodNumber;
+            createdBy: z.ZodString;
+            error: z.ZodNullable<z.ZodString>;
+        }, z.core.$strip>, "mutation">;
+        /** All export rows (history included), optionally scoped to one device. */
+        readonly listExports: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
+            deviceId: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>, z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            deviceId: z.ZodNumber;
+            profile: z.ZodString;
+            fromMs: z.ZodNumber;
+            toMs: z.ZodNumber;
+            options: z.ZodObject<{
+                speed: z.ZodOptional<z.ZodNumber>;
+                timelapse: z.ZodOptional<z.ZodObject<{
+                    everyMs: z.ZodNumber;
+                    outputFps: z.ZodOptional<z.ZodNumber>;
+                }, z.core.$strip>>;
+                includeAudio: z.ZodBoolean;
+                maxLifeMs: z.ZodNumber;
+                deleteAfterDownload: z.ZodBoolean;
+                title: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>;
+            state: z.ZodEnum<{
+                ready: "ready";
+                failed: "failed";
+                queued: "queued";
+                deleted: "deleted";
+                rendering: "rendering";
+                expired: "expired";
+            }>;
+            progressPct: z.ZodNullable<z.ZodNumber>;
+            fileBytes: z.ZodNullable<z.ZodNumber>;
+            expiresAt: z.ZodNumber;
+            deleteAfterDownload: z.ZodBoolean;
+            downloadedAt: z.ZodNullable<z.ZodNumber>;
+            createdAt: z.ZodNumber;
+            createdBy: z.ZodString;
+            error: z.ZodNullable<z.ZodString>;
+        }, z.core.$strip>>, "query">;
+        readonly getExport: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
+            exportId: z.ZodString;
+        }, z.core.$strip>, z.ZodObject<{
+            id: z.ZodString;
+            deviceId: z.ZodNumber;
+            profile: z.ZodString;
+            fromMs: z.ZodNumber;
+            toMs: z.ZodNumber;
+            options: z.ZodObject<{
+                speed: z.ZodOptional<z.ZodNumber>;
+                timelapse: z.ZodOptional<z.ZodObject<{
+                    everyMs: z.ZodNumber;
+                    outputFps: z.ZodOptional<z.ZodNumber>;
+                }, z.core.$strip>>;
+                includeAudio: z.ZodBoolean;
+                maxLifeMs: z.ZodNumber;
+                deleteAfterDownload: z.ZodBoolean;
+                title: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>;
+            state: z.ZodEnum<{
+                ready: "ready";
+                failed: "failed";
+                queued: "queued";
+                deleted: "deleted";
+                rendering: "rendering";
+                expired: "expired";
+            }>;
+            progressPct: z.ZodNullable<z.ZodNumber>;
+            fileBytes: z.ZodNullable<z.ZodNumber>;
+            expiresAt: z.ZodNumber;
+            deleteAfterDownload: z.ZodBoolean;
+            downloadedAt: z.ZodNullable<z.ZodNumber>;
+            createdAt: z.ZodNumber;
+            createdBy: z.ZodString;
+            error: z.ZodNullable<z.ZodString>;
+        }, z.core.$strip>, "query">;
+        /** Abort a queued/rendering export; the partial file is removed. */
+        readonly cancelExport: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
+            exportId: z.ZodString;
+        }, z.core.$strip>, z.ZodObject<{
+            id: z.ZodString;
+            deviceId: z.ZodNumber;
+            profile: z.ZodString;
+            fromMs: z.ZodNumber;
+            toMs: z.ZodNumber;
+            options: z.ZodObject<{
+                speed: z.ZodOptional<z.ZodNumber>;
+                timelapse: z.ZodOptional<z.ZodObject<{
+                    everyMs: z.ZodNumber;
+                    outputFps: z.ZodOptional<z.ZodNumber>;
+                }, z.core.$strip>>;
+                includeAudio: z.ZodBoolean;
+                maxLifeMs: z.ZodNumber;
+                deleteAfterDownload: z.ZodBoolean;
+                title: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>;
+            state: z.ZodEnum<{
+                ready: "ready";
+                failed: "failed";
+                queued: "queued";
+                deleted: "deleted";
+                rendering: "rendering";
+                expired: "expired";
+            }>;
+            progressPct: z.ZodNullable<z.ZodNumber>;
+            fileBytes: z.ZodNullable<z.ZodNumber>;
+            expiresAt: z.ZodNumber;
+            deleteAfterDownload: z.ZodBoolean;
+            downloadedAt: z.ZodNullable<z.ZodNumber>;
+            createdAt: z.ZodNumber;
+            createdBy: z.ZodString;
+            error: z.ZodNullable<z.ZodString>;
+        }, z.core.$strip>, "mutation">;
+        /** Remove the file but keep the history row (state → 'deleted'). */
+        readonly deleteExport: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
+            exportId: z.ZodString;
+        }, z.core.$strip>, z.ZodObject<{
+            id: z.ZodString;
+            deviceId: z.ZodNumber;
+            profile: z.ZodString;
+            fromMs: z.ZodNumber;
+            toMs: z.ZodNumber;
+            options: z.ZodObject<{
+                speed: z.ZodOptional<z.ZodNumber>;
+                timelapse: z.ZodOptional<z.ZodObject<{
+                    everyMs: z.ZodNumber;
+                    outputFps: z.ZodOptional<z.ZodNumber>;
+                }, z.core.$strip>>;
+                includeAudio: z.ZodBoolean;
+                maxLifeMs: z.ZodNumber;
+                deleteAfterDownload: z.ZodBoolean;
+                title: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>;
+            state: z.ZodEnum<{
+                ready: "ready";
+                failed: "failed";
+                queued: "queued";
+                deleted: "deleted";
+                rendering: "rendering";
+                expired: "expired";
+            }>;
+            progressPct: z.ZodNullable<z.ZodNumber>;
+            fileBytes: z.ZodNullable<z.ZodNumber>;
+            expiresAt: z.ZodNumber;
+            deleteAfterDownload: z.ZodBoolean;
+            downloadedAt: z.ZodNullable<z.ZodNumber>;
+            createdAt: z.ZodNumber;
+            createdBy: z.ZodString;
+            error: z.ZodNullable<z.ZodString>;
+        }, z.core.$strip>, "mutation">;
+        readonly getDownloadUrl: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
+            exportId: z.ZodString;
+        }, z.core.$strip>, z.ZodObject<{
+            url: z.ZodString;
+            endpoints: z.ZodArray<z.ZodString>;
+        }, z.core.$strip>, "query">;
+    };
+};
+export type IRecordingExportProvider = InferProvider<typeof recordingExportCapability>;

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

@@ -464,14 +464,68 @@ export declare const recordingCapability: {
             storageBytes: z.ZodNumber;
         }, z.core.$strip>, "mutation">;
         /** Apply this device's retention policy to footage now; returns the oldest
-         *  surviving footage start (the retention floor) or null if no footage. */
+         *  surviving footage start (the retention floor) or null if no footage. The
+         *  prune is logged to the recordings ops-log with `reason` (default
+         *  `'retention'` — the policy-driven prune; `'quota'` when disk-pressure
+         *  triggered). */
         readonly pruneFootage: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
             deviceId: z.ZodNumber;
+            reason: z.ZodOptional<z.ZodEnum<{
+                manual: "manual";
+                retention: "retention";
+                quota: "quota";
+                operator: "operator";
+            }>>;
         }, z.core.$strip>, z.ZodObject<{
             floorMs: z.ZodNullable<z.ZodNumber>;
             deletedBuckets: z.ZodNumber;
             reclaimedBytes: z.ZodNumber;
         }, z.core.$strip>, "mutation">;
+        /**
+         * Manually delete a camera's footage — the whole footprint, or a
+         * `[fromMs, toMs)` window when either bound is given. Logged to the
+         * recordings ops-log as `op:'manual-delete', reason:'manual'`. Destructive:
+         * the admin UI guards it behind a confirm.
+         */
+        readonly deleteFootprint: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
+            deviceId: z.ZodNumber;
+            fromMs: z.ZodOptional<z.ZodNumber>;
+            toMs: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>, z.ZodObject<{
+            deletedBuckets: z.ZodNumber;
+            reclaimedBytes: z.ZodNumber;
+        }, z.core.$strip>, "mutation">;
+        /** The recordings ops-log rows (newest-first), optionally scoped to one
+         *  camera. Backed by the recorder's bounded DurableState ring. */
+        readonly listOpsLog: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
+            deviceId: z.ZodOptional<z.ZodNumber>;
+            limit: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>, z.ZodReadonly<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            at: z.ZodNumber;
+            domain: z.ZodEnum<{
+                events: "events";
+                recording: "recording";
+            }>;
+            op: z.ZodEnum<{
+                prune: "prune";
+                "manual-delete": "manual-delete";
+                rescan: "rescan";
+                "retention-run": "retention-run";
+            }>;
+            reason: z.ZodEnum<{
+                manual: "manual";
+                retention: "retention";
+                quota: "quota";
+                operator: "operator";
+            }>;
+            deviceId: z.ZodNullable<z.ZodNumber>;
+            nodeId: z.ZodString;
+            itemsAffected: z.ZodNumber;
+            bytesReclaimed: z.ZodNumber;
+            detail: z.ZodNullable<z.ZodString>;
+            actor: z.ZodString;
+        }, z.core.$strip>>>, "query">;
     };
 };
 export type IRecordingProvider = InferProvider<typeof recordingCapability>;