@camstack/types 1.1.48 → 1.1.49

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-BfvNtyu8.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-DOq2moJx.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

@@ -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<{
@@ -922,6 +926,7 @@ export declare const pipelineAnalyticsCapability: {
                 vehicle: "vehicle";
                 animal: "animal";
                 motion: "motion";
+                package: "package";
                 door: "door";
                 pir: "pir";
                 smoke: "smoke";
@@ -932,6 +937,7 @@ export declare const pipelineAnalyticsCapability: {
                 audio: "audio";
                 custom: "custom";
                 motion: "motion";
+                package: "package";
                 detection: "detection";
             }>;
             source: z.ZodObject<{

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/zone-rules.cap.d.ts

@@ -12,6 +12,7 @@ import { DeviceType } from '../device/device-type.js';
  */
 export declare const ZoneRuleStageEnum: z.ZodEnum<{
     motion: "motion";
+    package: "package";
     detection: "detection";
 }>;
 export type ZoneRuleStage = z.infer<typeof ZoneRuleStageEnum>;
@@ -44,6 +45,7 @@ export declare const zoneRulesCapability: {
             deviceId: z.ZodNumber;
             stage: z.ZodEnum<{
                 motion: "motion";
+                package: "package";
                 detection: "detection";
             }>;
         }, z.core.$strip>, z.ZodReadonly<z.ZodArray<z.ZodObject<{
@@ -68,6 +70,7 @@ export declare const zoneRulesCapability: {
             deviceId: z.ZodNumber;
             stage: z.ZodEnum<{
                 motion: "motion";
+                package: "package";
                 detection: "detection";
             }>;
             rules: z.ZodReadonly<z.ZodArray<z.ZodObject<{
@@ -87,12 +90,19 @@ export declare const zoneRulesCapability: {
         }, z.core.$strip>, z.ZodVoid, "mutation">;
     };
     /**
-     * Runtime-state slice — both stages mirrored together so consumers
+     * Runtime-state slice — every stage mirrored together so consumers
      * see one reactive handle (`device.state.zoneRules.value`) instead
-     * of two. Bulk-replace mutations on either stage write the full
-     * `{motion, detection}` shape, so subscribers always get the
+     * of one per stage. Bulk-replace mutations on any stage write the full
+     * `{motion, detection, package}` shape, so subscribers always get the
      * complete current set. Consumers that only care about one stage
      * just read the matching property.
+     *
+     * `package` backs the package-drop detector — a package zone is a
+     * `ZoneRule` on the `'package'` stage referencing drawn polygons
+     * (see docs/superpowers/specs/2026-07-17-package-zones-design.md §3.1).
+     * The orchestrator provider that writes this stage lands in a later
+     * slice; until then the mirror carries only `{motion, detection}` and
+     * consumers read `package` as absent (treat as `[]`).
      */
     readonly runtimeState: z.ZodObject<{
         motion: z.ZodReadonly<z.ZodArray<z.ZodObject<{
@@ -123,6 +133,20 @@ export declare const zoneRulesCapability: {
             preferMask: z.ZodOptional<z.ZodBoolean>;
             enabled: z.ZodDefault<z.ZodBoolean>;
         }, z.core.$strip>>>;
+        package: z.ZodReadonly<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            name: z.ZodOptional<z.ZodString>;
+            zoneIds: z.ZodReadonly<z.ZodArray<z.ZodString>>;
+            mode: z.ZodEnum<{
+                include: "include";
+                exclude: "exclude";
+            }>;
+            classFilter: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodString>>>;
+            overlapThreshold: z.ZodOptional<z.ZodNumber>;
+            bboxInclusionPct: z.ZodOptional<z.ZodNumber>;
+            preferMask: z.ZodOptional<z.ZodBoolean>;
+            enabled: z.ZodDefault<z.ZodBoolean>;
+        }, z.core.$strip>>>;
     }, z.core.$strip>;
 };
 export type IZoneRulesProvider = InferProvider<typeof zoneRulesCapability>;

package/dist/enums/event-category.d.ts

@@ -150,6 +150,11 @@ export declare enum EventCategory {
     /** Runner-sampled scrub thumbnail (~1/5 s/camera). Telemetry (D8): a lost
      *  thumb is a scrub gap the recorder's keyframe backfill covers. */
     RecordingThumbSampled = "recording.thumb-sampled",
+    /** Export render progress (0–100). Telemetry (D8): a lost tick is a stale
+     *  progress bar the client reconciles via `recordingExport.getExport`. */
+    RecordingExportProgress = "recording.export.progress",
+    RecordingExportCompleted = "recording.export.completed",
+    RecordingExportFailed = "recording.export.failed",
     DetectionEvent = "detection.event",
     SessionTrackNew = "session.track.new",
     SessionTrackExpired = "session.track.expired",
@@ -438,6 +443,25 @@ export declare enum EventCategory {
      * `{ deviceId, entryId, className, phase:'appeared'|'departed', timestamp }`.
      */
     PipelineAnalyticsStationaryChanged = "pipeline-analytics.stationary-changed",
+    /**
+     * Fired by `addon-post-analysis` when a package-drop is confirmed inside
+     * a package zone — a newly-appeared stationary object of a package class
+     * that cleared the class / zone / dwell / size gates. Payload:
+     * `PipelineAnalyticsPackageDeliveredPayload` carrying `{ deviceId,
+     * entryId, className, zoneIds, keyFrameMediaKey?, bbox, timestamp }`.
+     * Telemetry (D8): the durable record is the `package-events` store row;
+     * this bus topic drives notifier rules + live UI. See
+     * docs/superpowers/specs/2026-07-17-package-zones-design.md §5.1.
+     */
+    PipelineAnalyticsPackageDelivered = "pipeline-analytics.package-delivered",
+    /**
+     * Fired by `addon-post-analysis` when a previously-delivered package
+     * leaves its zone (the stationary entry departed — moved or swept).
+     * Payload: `PipelineAnalyticsPackagePickedUpPayload` carrying
+     * `{ deviceId, entryId, deliveredEventId, className, timestamp }`.
+     * Telemetry (D8). See package-zones-design §5.2.
+     */
+    PipelineAnalyticsPackagePickedUp = "pipeline-analytics.package-picked-up",
     /**
      * Fired by `addon-post-analysis` whenever a gallery face row changes:
      * `kind:'buffered'` a new detected face was persisted, `'assigned'` /

package/dist/enums.js

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_event_category = require("./event-category-AkBNxg_X.js");
+const require_event_category = require("./event-category-CGj9fI4L.js");
 //#region src/enums/event-source-type.ts
 var EventSourceType = /* @__PURE__ */ function(EventSourceType) {
 	EventSourceType["Addon"] = "addon";

package/dist/enums.mjs

@@ -1,4 +1,4 @@
-import { t as EventCategory } from "./event-category-H4AVePnn.mjs";
+import { t as EventCategory } from "./event-category-D4HJq7Mw.mjs";
 //#region src/enums/event-source-type.ts
 var EventSourceType = /* @__PURE__ */ function(EventSourceType) {
 	EventSourceType["Addon"] = "addon";

package/dist/{event-category-AkBNxg_X.js → event-category-CGj9fI4L.js}

@@ -151,6 +151,11 @@ var EventCategory = /* @__PURE__ */ function(EventCategory) {
 	/** Runner-sampled scrub thumbnail (~1/5 s/camera). Telemetry (D8): a lost
 	*  thumb is a scrub gap the recorder's keyframe backfill covers. */
 	EventCategory["RecordingThumbSampled"] = "recording.thumb-sampled";
+	/** Export render progress (0–100). Telemetry (D8): a lost tick is a stale
+	*  progress bar the client reconciles via `recordingExport.getExport`. */
+	EventCategory["RecordingExportProgress"] = "recording.export.progress";
+	EventCategory["RecordingExportCompleted"] = "recording.export.completed";
+	EventCategory["RecordingExportFailed"] = "recording.export.failed";
 	EventCategory["DetectionEvent"] = "detection.event";
 	EventCategory["SessionTrackNew"] = "session.track.new";
 	EventCategory["SessionTrackExpired"] = "session.track.expired";
@@ -440,6 +445,25 @@ var EventCategory = /* @__PURE__ */ function(EventCategory) {
 	*/
 	EventCategory["PipelineAnalyticsStationaryChanged"] = "pipeline-analytics.stationary-changed";
 	/**
+	* Fired by `addon-post-analysis` when a package-drop is confirmed inside
+	* a package zone — a newly-appeared stationary object of a package class
+	* that cleared the class / zone / dwell / size gates. Payload:
+	* `PipelineAnalyticsPackageDeliveredPayload` carrying `{ deviceId,
+	* entryId, className, zoneIds, keyFrameMediaKey?, bbox, timestamp }`.
+	* Telemetry (D8): the durable record is the `package-events` store row;
+	* this bus topic drives notifier rules + live UI. See
+	* docs/superpowers/specs/2026-07-17-package-zones-design.md §5.1.
+	*/
+	EventCategory["PipelineAnalyticsPackageDelivered"] = "pipeline-analytics.package-delivered";
+	/**
+	* Fired by `addon-post-analysis` when a previously-delivered package
+	* leaves its zone (the stationary entry departed — moved or swept).
+	* Payload: `PipelineAnalyticsPackagePickedUpPayload` carrying
+	* `{ deviceId, entryId, deliveredEventId, className, timestamp }`.
+	* Telemetry (D8). See package-zones-design §5.2.
+	*/
+	EventCategory["PipelineAnalyticsPackagePickedUp"] = "pipeline-analytics.package-picked-up";
+	/**
 	* Fired by `addon-post-analysis` whenever a gallery face row changes:
 	* `kind:'buffered'` a new detected face was persisted, `'assigned'` /
 	* `'unassigned'` its identity link changed, `'deleted'` the row was

package/dist/{event-category-H4AVePnn.mjs → event-category-D4HJq7Mw.mjs}

@@ -151,6 +151,11 @@ var EventCategory = /* @__PURE__ */ function(EventCategory) {
 	/** Runner-sampled scrub thumbnail (~1/5 s/camera). Telemetry (D8): a lost
 	*  thumb is a scrub gap the recorder's keyframe backfill covers. */
 	EventCategory["RecordingThumbSampled"] = "recording.thumb-sampled";
+	/** Export render progress (0–100). Telemetry (D8): a lost tick is a stale
+	*  progress bar the client reconciles via `recordingExport.getExport`. */
+	EventCategory["RecordingExportProgress"] = "recording.export.progress";
+	EventCategory["RecordingExportCompleted"] = "recording.export.completed";
+	EventCategory["RecordingExportFailed"] = "recording.export.failed";
 	EventCategory["DetectionEvent"] = "detection.event";
 	EventCategory["SessionTrackNew"] = "session.track.new";
 	EventCategory["SessionTrackExpired"] = "session.track.expired";
@@ -440,6 +445,25 @@ var EventCategory = /* @__PURE__ */ function(EventCategory) {
 	*/
 	EventCategory["PipelineAnalyticsStationaryChanged"] = "pipeline-analytics.stationary-changed";
 	/**
+	* Fired by `addon-post-analysis` when a package-drop is confirmed inside
+	* a package zone — a newly-appeared stationary object of a package class
+	* that cleared the class / zone / dwell / size gates. Payload:
+	* `PipelineAnalyticsPackageDeliveredPayload` carrying `{ deviceId,
+	* entryId, className, zoneIds, keyFrameMediaKey?, bbox, timestamp }`.
+	* Telemetry (D8): the durable record is the `package-events` store row;
+	* this bus topic drives notifier rules + live UI. See
+	* docs/superpowers/specs/2026-07-17-package-zones-design.md §5.1.
+	*/
+	EventCategory["PipelineAnalyticsPackageDelivered"] = "pipeline-analytics.package-delivered";
+	/**
+	* Fired by `addon-post-analysis` when a previously-delivered package
+	* leaves its zone (the stationary entry departed — moved or swept).
+	* Payload: `PipelineAnalyticsPackagePickedUpPayload` carrying
+	* `{ deviceId, entryId, deliveredEventId, className, timestamp }`.
+	* Telemetry (D8). See package-zones-design §5.2.
+	*/
+	EventCategory["PipelineAnalyticsPackagePickedUp"] = "pipeline-analytics.package-picked-up";
+	/**
 	* Fired by `addon-post-analysis` whenever a gallery face row changes:
 	* `kind:'buffered'` a new detected face was persisted, `'assigned'` /
 	* `'unassigned'` its identity link changed, `'deleted'` the row was