@camstack/types 0.1.14 → 0.1.16

package/dist/interfaces/storage.d.ts

@@ -1,9 +1,5 @@
-/**
- * All location types that storage providers can serve.
- * Each type maps to a logical category of files.
- * A storage provider declares which location types it supports.
- */
-export type StorageLocationType = 'recordings-high' | 'recordings-low' | 'recordings-clips' | 'event-images' | 'models' | 'addons-data' | 'cache' | 'logs';
+export type { StorageLocationType } from './storage-location.js';
+import type { StorageLocationType } from './storage-location.js';
 /** All location types as an array (for iteration) */
 export declare const STORAGE_LOCATION_TYPES: readonly StorageLocationType[];
 /** Default subdirectory names for filesystem storage */
@@ -13,60 +9,128 @@ export declare const DEFAULT_LOCATION_SUBDIRS: Readonly<Record<StorageLocationTy
  * Multiple providers can coexist (local filesystem, NAS, S3, etc.).
  * Each addon/system setting selects which provider to use per location type.
  */
+export interface StorageResolveInput {
+    readonly location: StorageLocationType;
+    readonly relativePath: string;
+}
+export interface StorageWriteInput {
+    readonly location: StorageLocationType;
+    readonly relativePath: string;
+    readonly data: Buffer | NodeJS.ReadableStream;
+}
+export interface StorageReadInput {
+    readonly location: StorageLocationType;
+    readonly relativePath: string;
+}
+export interface StorageExistsInput {
+    readonly location: StorageLocationType;
+    readonly relativePath: string;
+}
+export interface StorageListInput {
+    readonly location: StorageLocationType;
+    readonly prefix?: string;
+}
+export interface StorageDeleteInput {
+    readonly location: StorageLocationType;
+    readonly relativePath: string;
+}
+export interface StorageAvailableSpaceInput {
+    readonly location: StorageLocationType;
+}
 export interface IStorageProvider {
-    /** Unique provider ID (e.g., 'local', 'nas-synology', 's3-aws') */
     readonly id: string;
-    /** Human-readable name (e.g., 'Local Filesystem', 'Synology NAS') */
     readonly name: string;
-    /** Which location types this provider serves */
     readonly supportedLocations: readonly StorageLocationType[];
-    /** Resolve an absolute path/URL for a file within a location */
-    resolve(location: StorageLocationType, relativePath: string): string;
-    /** Write file data */
-    write(location: StorageLocationType, relativePath: string, data: Buffer | NodeJS.ReadableStream): Promise<void>;
-    /** Read file data */
-    read(location: StorageLocationType, relativePath: string): Promise<Buffer>;
-    /** Check if a file exists */
-    exists(location: StorageLocationType, relativePath: string): Promise<boolean>;
-    /** List files/directories under a prefix within a location */
-    list(location: StorageLocationType, prefix?: string): Promise<readonly string[]>;
-    /** Delete a file */
-    delete(location: StorageLocationType, relativePath: string): Promise<void>;
-    /** Get available space in bytes, null if unknown (e.g., S3) */
-    getAvailableSpace(location: StorageLocationType): Promise<number | null>;
-    /** Lifecycle */
-    initialize(): Promise<void>;
-    shutdown(): Promise<void>;
+    resolve(input: StorageResolveInput): string;
+    write(input: StorageWriteInput): Promise<void>;
+    read(input: StorageReadInput): Promise<Buffer>;
+    exists(input: StorageExistsInput): Promise<boolean>;
+    list(input: StorageListInput): Promise<readonly string[]>;
+    delete(input: StorageDeleteInput): Promise<void>;
+    getAvailableSpace(input: StorageAvailableSpaceInput): Promise<number | null>;
 }
 /**
  * All named collections that the settings backend manages.
  * Each collection maps to a logical table/bucket in the backend.
  */
-export type SettingsCollection = 'system-settings' | 'addon-settings' | 'provider-settings' | 'device-settings' | 'detection-events' | 'audio-levels' | 'track-trails' | 'recording-segments' | 'recording-thumbnails' | 'recording-policies' | 'recording-storage-config' | 'recording-cleanup-queue' | 'known-faces';
+export type SettingsCollection = 'system-settings' | 'addon-settings' | 'provider-settings' | 'device-settings' | 'detection-events' | 'audio-levels' | 'track-trails' | 'recording-segments' | 'recording-thumbnails' | 'recording-policies' | 'recording-storage-config' | 'recording-cleanup-queue' | 'known-faces' | (string & {});
+export interface SettingsGetInput {
+    readonly namespace?: string;
+    readonly collection: SettingsCollection;
+    readonly key: string;
+}
+export interface SettingsSetInput {
+    readonly namespace?: string;
+    readonly collection: SettingsCollection;
+    readonly key: string;
+    readonly value: unknown;
+}
+export interface SettingsQueryInput {
+    readonly namespace?: string;
+    readonly collection: SettingsCollection;
+    readonly filter?: QueryFilter;
+}
+export interface SettingsInsertInput<T extends object = Record<string, unknown>> {
+    readonly namespace?: string;
+    readonly collection: SettingsCollection;
+    readonly record: SettingsRecord<T>;
+}
+export interface SettingsUpdateInput {
+    readonly namespace?: string;
+    readonly collection: SettingsCollection;
+    readonly id: string;
+    readonly data: Record<string, unknown>;
+}
+export interface SettingsDeleteInput {
+    readonly namespace?: string;
+    readonly collection: SettingsCollection;
+    readonly key: string;
+}
+export interface SettingsCountInput {
+    readonly namespace?: string;
+    readonly collection: SettingsCollection;
+    readonly filter?: QueryFilter;
+}
+export interface SettingsIsEmptyInput {
+    readonly namespace?: string;
+    readonly collection: SettingsCollection;
+}
 /**
  * Settings backend — persistent key-value and document storage.
  * Default implementation: SQLite. Can be replaced by Postgres, etc.
+ * All methods use object-arg signatures for extensibility.
  */
 export interface ISettingsBackend {
     /** Get a single value by key from a collection */
-    get(collection: SettingsCollection, key: string): Promise<unknown>;
+    get(input: SettingsGetInput): Promise<unknown>;
     /** Set a value by key in a collection (upsert) */
-    set(collection: SettingsCollection, key: string, value: unknown): Promise<void>;
+    set(input: SettingsSetInput): Promise<void>;
     /** Get all entries matching an optional filter */
-    query(collection: SettingsCollection, filter?: QueryFilter): Promise<readonly SettingsRecord[]>;
+    query<T extends object = Record<string, unknown>>(input: SettingsQueryInput): Promise<readonly SettingsRecord<T>[]>;
     /** Insert a new record */
-    insert(collection: SettingsCollection, record: SettingsRecord): Promise<void>;
+    insert<T extends object = Record<string, unknown>>(input: SettingsInsertInput<T>): Promise<void>;
     /** Update an existing record by ID */
-    update(collection: SettingsCollection, id: string, data: Record<string, unknown>): Promise<void>;
+    update(input: SettingsUpdateInput): Promise<void>;
     /** Delete a record by key/ID */
-    delete(collection: SettingsCollection, key: string): Promise<void>;
+    delete(input: SettingsDeleteInput): Promise<void>;
     /** Count entries in a collection */
-    count(collection: SettingsCollection, filter?: QueryFilter): Promise<number>;
+    count(input: SettingsCountInput): Promise<number>;
     /** Check if a collection is empty (used for first-boot detection) */
-    isEmpty(collection: SettingsCollection): Promise<boolean>;
-    /** Lifecycle */
-    initialize(): Promise<void>;
-    shutdown(): Promise<void>;
+    isEmpty(input: SettingsIsEmptyInput): Promise<boolean>;
+    /**
+     * Declare a typed (SQL-backed) collection. After declaration, the
+     * standard `insert` / `update` / `delete` / `query` methods route to
+     * typed columns for this collection instead of the JSON-blob default.
+     * Idempotent — re-declaring the same shape is a no-op. Backends
+     * without typed-table support should implement this as a no-op so
+     * the cap contract stays uniform.
+     */
+    declareCollection(input: {
+        namespace?: string;
+        collection: string;
+        columns: readonly import('../capabilities/settings-store.cap.js').CollectionColumn[];
+        indexes?: readonly import('../capabilities/settings-store.cap.js').CollectionIndex[];
+    }): Promise<void>;
     /** Ensure a structured table exists (CREATE TABLE IF NOT EXISTS) */
     ensureTable?(table: string, schema: TableSchema): Promise<void>;
     /** Insert a row into a structured table */
@@ -82,9 +146,9 @@ export interface ISettingsBackend {
     /** Count rows matching a filter */
     tableCount?(table: string, filter?: Record<string, unknown>): Promise<number>;
 }
-export interface SettingsRecord {
+export interface SettingsRecord<T extends object = Record<string, unknown>> {
     readonly id: string;
-    readonly data: Record<string, unknown>;
+    readonly data: T;
 }
 export interface QueryFilter {
     where?: Record<string, unknown>;
@@ -181,19 +245,21 @@ export interface EmbeddingFilter {
     /** Filter by device */
     readonly deviceId?: string;
 }
-/** @deprecated Use StorageLocationType instead */
-export type StorageLocationName = StorageLocationType | 'data' | 'media' | 'recordings' | 'config' | 'events' | 'addon';
-/** @deprecated Use IStorageProvider instead */
-export interface StorageConfig {
-    locations: Record<string, string>;
-}
-/** @deprecated Use SettingsRecord instead */
+/**
+ * A document record in collection-based storage.
+ * Used by IStructuredStorage and ElementConfigStore.
+ * New code should prefer ISettingsBackend + SettingsRecord.
+ */
 export interface StorageRecord {
     collection: string;
     id: string;
     data: Record<string, unknown>;
 }
-/** @deprecated Use ISettingsBackend instead */
+/**
+ * Collection-based document storage (query, insert, update, delete).
+ * Used by ElementConfigStore and StorageManager shim layer.
+ * New code should prefer ISettingsBackend.
+ */
 export interface IStructuredStorage {
     query(collection: string, filter?: QueryFilter): Promise<readonly StorageRecord[]>;
     insert(record: StorageRecord): Promise<StorageRecord>;
@@ -201,7 +267,11 @@ export interface IStructuredStorage {
     delete(collection: string, id: string): Promise<void>;
     count(collection: string, filter?: QueryFilter): Promise<number>;
 }
-/** @deprecated Use IStorageProvider.read/write instead */
+/**
+ * File-based storage operations.
+ * Used by StorageManager and addons for media/model files.
+ * New code should prefer IStorageProvider.
+ */
 export interface IFileStorage {
     readFile(path: string): Promise<Buffer>;
     writeFile(path: string, data: Buffer): Promise<void>;
@@ -210,7 +280,11 @@ export interface IFileStorage {
     getFileUrl(path: string): Promise<string>;
     exists(path: string): Promise<boolean>;
 }
-/** @deprecated Use IStorageProvider instead */
+/**
+ * Combined storage location with optional structured + file storage.
+ * Used by StorageManager.getLocation() and ElementConfigStore.
+ * New code should prefer IStorageProvider + ISettingsBackend.
+ */
 export interface IStorageLocation {
     structured?: IStructuredStorage;
     files?: IFileStorage;

package/dist/interfaces/storage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../../src/interfaces/storage.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../../src/interfaces/storage.ts"],"names":[],"mappings":"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"}

package/dist/interfaces/stream-broker.d.ts

@@ -1,10 +1,72 @@
+import { z } from 'zod';
+import type { FrameFormat } from '../types/io.js';
+export declare const DecoderStatsSchema: z.ZodObject<{
+    inputFps: z.ZodNumber;
+    outputFps: z.ZodNumber;
+    avgDecodeTimeMs: z.ZodNumber;
+    droppedFrames: z.ZodNumber;
+}, z.core.$strip>;
+export declare const DecoderSessionConfigSchema: z.ZodObject<{
+    codec: z.ZodString;
+    maxFps: z.ZodDefault<z.ZodNumber>;
+    outputFormat: z.ZodDefault<z.ZodEnum<{
+        jpeg: "jpeg";
+        rgb: "rgb";
+        bgr: "bgr";
+        yuv420: "yuv420";
+        gray: "gray";
+    }>>;
+    scale: z.ZodDefault<z.ZodNumber>;
+    width: z.ZodOptional<z.ZodNumber>;
+    height: z.ZodOptional<z.ZodNumber>;
+    deviceId: z.ZodOptional<z.ZodNumber>;
+    tag: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
 export type Unsubscribe = () => void;
+/**
+ * Discriminator for `StreamSource.type`. Values that the broker
+ * understands today:
+ *
+ * - `'rtsp'`     — pull mode. Broker connects to a `rtsp://` URL,
+ *                   demuxes RTP, exposes raw RTP via `onVideoRtp`.
+ * - `'rtmp'`     — pull mode. Broker connects to a `rtmp://` URL,
+ *                   demuxes flv into AnnexB packets. No source RTP
+ *                   available (RTMP carries no RTP), so the WebRTC
+ *                   path falls back to AnnexB → writeVideoNals.
+ *                   Reserved — implementation pending.
+ * - `'push'`     — push mode. Provider addon delivers AnnexB packets
+ *                   via `pushEncodedPacket()` (Reolink Baichuan,
+ *                   Frigate event streams, etc.).
+ * - `'push-rtp'` — push mode with raw RTP packets. Provider addon
+ *                   delivers source RTP via `pushVideoRtp()` AND
+ *                   AnnexB-equivalents via `pushEncodedPacket()` so
+ *                   downstream consumers (decoder, restreamer) keep
+ *                   working. Lets the WebRTC path use the H.265
+ *                   repacketizer for push-mode H.265 streams. Reserved
+ *                   — implementation pending.
+ * - `'placeholder'` — silent black-image placeholder reader.
+ *
+ * String type instead of a literal union so addons remain free to
+ * add new source types — the broker's switch statement falls through
+ * to "data is pushed externally" for unknown values.
+ */
+export type StreamSourceType = 'rtsp' | 'rtmp' | 'push' | 'push-rtp' | 'rfc4571' | 'placeholder' | (string & {});
 export interface StreamSource {
-    readonly type: string;
+    readonly type: StreamSourceType;
+    /** Stream URL — required for pull-based sources (rtsp, rtmp). Not used for push sources. */
     readonly url: string;
     readonly videoCodec?: string;
     readonly audioCodec?: string;
     readonly metadata?: Readonly<Record<string, unknown>>;
+    /**
+     * Push-source flag — when true, a stall in the input stream is
+     * treated as a valid suspension (battery cameras intentionally go
+     * silent between motion events) rather than an error. The broker
+     * stops emitting the black-image placeholder and pauses the watchdog
+     * until the next packet arrives. Default: false (legacy behaviour —
+     * stall is an error).
+     */
+    readonly allowStall?: boolean;
 }
 export interface StreamSourceOption {
     readonly id: string;
@@ -23,12 +85,40 @@ export interface EncodedPacket {
     readonly dts: number;
     readonly keyframe: boolean;
     readonly codec: string;
+    /**
+     * `true` when the packet was synthesized by the broker's placeholder
+     * pump (state-aware "RECONNECTING" / "SLEEPING" / etc. keyframes
+     * pushed at 1Hz while no real RTP is flowing). Consumers that
+     * accumulate per-stream codec state (sticky SPS/PPS, decoder config)
+     * MUST treat these as throwaway: the placeholder is a different
+     * resolution and parameter set than the live camera, so caching its
+     * SPS/PPS and prepending them to real keyframes silently corrupts
+     * the decoder state and freezes the WebRTC viewer on the last
+     * placeholder until the consumer is re-created. Absent on packets
+     * produced from real source data.
+     */
+    readonly isPlaceholder?: boolean;
+}
+/**
+ * Audio metadata declared by push-source providers before they emit the
+ * first audio `EncodedPacket`. Mirrors the slice of an SDP audio track
+ * the broker actually consumes — `codec` is canonical lowercase
+ * ('aac' | 'opus' | 'pcmu' | 'pcma' | ...).
+ *
+ * `extraData` carries codec-specific config bytes (e.g. AAC
+ * AudioSpecificConfig) when the codec needs them at decoder-init time.
+ */
+export interface PushAudioInfo {
+    readonly codec: string;
+    readonly sampleRate: number;
+    readonly channels: number;
+    readonly extraData?: Uint8Array;
 }
 export interface DecodedFrame {
     readonly data: Buffer;
     readonly width: number;
     readonly height: number;
-    readonly format: 'jpeg' | 'rgb' | 'yuv420';
+    readonly format: FrameFormat;
     readonly timestamp: number;
 }
 export interface DecodedAudioChunk {
@@ -39,8 +129,20 @@ export interface DecodedAudioChunk {
 }
 export interface DecodeOptions {
     readonly maxFps?: number;
-    readonly format?: 'jpeg' | 'rgb' | 'yuv420';
+    readonly format?: FrameFormat;
     readonly scale?: number;
+    /**
+     * Caller identity tag (Phase 10). Surfaced by `listClients` so
+     * operators can tell who's holding the broker open. Short and stable:
+     * `motion`, `detection`, `snapshot`, `webrtc:<sessionId>`,
+     * `benchmark`. Missing tag → recorded as `'unknown'` with a broker-
+     * side warn log.
+     */
+    readonly tag?: string;
+}
+export interface AudioSubscribeOptions {
+    /** Caller identity tag. See DecodeOptions.tag. */
+    readonly tag?: string;
 }
 export type BrokerStatus = 'idle' | 'connecting' | 'streaming' | 'error' | 'stopped';
 export interface BrokerStats {
@@ -50,43 +152,209 @@ export interface BrokerStats {
     readonly encodedSubscribers: number;
     readonly decodedSubscribers: number;
     readonly uptimeMs: number;
+    /** Measured bitrate in kbps (averaged over 2s window) */
+    readonly bitrateKbps: number;
+    /** Time between last two keyframes in ms (IDR interval) */
+    readonly idrIntervalMs: number;
+    /** Detected video codec (h264, h265) */
+    readonly codec?: string;
+    /** Total bytes received since broker start */
+    readonly totalBytes: number;
+    /** Total encoded packets received since broker start */
+    readonly packetCount: number;
+    /** Number of connected RTSP restream clients */
+    readonly rtspClients: number;
+    /** Number of connected TCP pipe clients */
+    readonly pipeClients: number;
+    /** Pre-buffer configured duration in seconds */
+    readonly preBufferSec: number;
+    /** Pre-buffer actual buffered duration in ms */
+    readonly preBufferMs: number;
+    /** Pre-buffer packet count */
+    readonly preBufferPackets: number;
+    /**
+     * Moleculer node id of the decoder provider currently servicing this
+     * stream's decoded subscribers. `null` until the deferred decoder is
+     * created (no decoded clients yet, or codec not detected).
+     */
+    readonly decoderNodeId: string | null;
+    /**
+     * Detected audio track parameters from the RTSP DESCRIBE / SDP. Null
+     * when the stream has no audio track or the broker is still in cold
+     * start. `supported` reflects whether the local native + ffmpeg-based
+     * decoder pipeline can produce PCM chunks for downstream consumers
+     * (audio-analyzer). When `false`, the codec is detected but skipped.
+     */
+    readonly audio?: {
+        readonly codec: string;
+        readonly sampleRate: number;
+        readonly channels: number;
+        readonly supported: boolean;
+    } | null;
 }
 export interface IStreamBroker {
     readonly deviceId: string;
     readonly status: BrokerStatus;
+    readonly suspended: boolean;
     start(source: StreamSource): Promise<void>;
     stop(): Promise<void>;
+    /**
+     * Push an encoded packet into the broker from an external source.
+     *
+     * Used by camera provider addons that deliver media data directly
+     * (e.g. Reolink Baichuan protocol, Frigate event streams) instead
+     * of exposing an RTSP URL for the broker to pull from.
+     *
+     * The broker fans out the packet to all consumers: pre-buffer, RTSP
+     * restreamer, TCP pipe, decoder sessions, and encoded subscribers.
+     */
+    pushEncodedPacket(packet: EncodedPacket): void;
+    /**
+     * Push-source audio metadata. Push providers (Reolink Baichuan,
+     * Frigate, etc.) call this BEFORE the first audio EncodedPacket so
+     * the broker can wire the audio-codec capability — RTSP sources get
+     * the same data from the SDP audio track. Repeat calls update the
+     * declared codec; calling with `null` retracts (broker tears down
+     * any audio decode session).
+     *
+     * Typical Reolink Baichuan audio: AAC-LC 16 kHz mono. Cameras that
+     * push G.711 should still call this so the broker can bypass the
+     * codec cap for the supported native codecs.
+     */
+    pushAudioInfo?(info: PushAudioInfo | null): void;
+    /**
+     * Push a raw video RTP packet from an external source (used by
+     * `'push-rtp'`-typed sources, e.g. Reolink Baichuan adapter that
+     * synthesizes RTP from its packetizer-friendly access units). The
+     * broker fans out to `onVideoRtp` subscribers, including the
+     * WebRTC server's H.265 repacketizer path.
+     *
+     * Sources that don't carry per-packet RTP MAY ignore this entirely
+     * and call only `pushEncodedPacket`. Implementations are free to
+     * be a no-op when no RTP subscribers exist.
+     */
+    pushVideoRtp?(rtpData: Buffer): void;
     onEncodedData(callback: (packet: EncodedPacket) => void): Unsubscribe;
+    /**
+     * Subscribe to source video RTP packets (raw on-wire bytes, before
+     * depacketization). Used by the WebRTC server's H.265 path to feed
+     * a packet-level repacketizer that preserves the original RTP header
+     * layout — Chrome's HEVC depacketizer is sensitive to it.
+     *
+     * Sources that don't have an underlying RTP wire (e.g. Frigate event
+     * streams that call `pushEncodedPacket`) MAY register zero callbacks
+     * and emit nothing.
+     */
+    onVideoRtp(callback: (rtpData: Buffer) => void): Unsubscribe;
+    /**
+     * Codec parameter sets harvested from the camera's SDP (sprop-vps /
+     * sprop-sps / sprop-pps). Cameras like Reolink high-profile streams
+     * publish VPS/SPS/PPS only via SDP — Chrome's HEVC decoder needs them
+     * to initialise. Returns null when the broker hasn't connected yet
+     * or the camera ships param sets in-band.
+     */
+    getSdpParameterSets(): ReadonlyArray<Buffer> | null;
+    /**
+     * Subscribe to SDP-derived VPS/SPS/PPS deliveries. Fires once
+     * synchronously if the broker already has them (late-subscriber
+     * shape), and again every time `onVideoTrack` repopulates them on a
+     * reader rebuild. Used by the WebRTC server's H.265 path so a
+     * session created during the wake-up window — when
+     * `getSdpParameterSets()` still returns null — can seed its
+     * `H265Repacketizer` once the camera's first RTP+SDP arrive.
+     */
+    onSdpParameterSets(callback: (ps: ReadonlyArray<Buffer>) => void): Unsubscribe;
+    /**
+     * Source type as configured at `start()` — see `StreamSourceType`
+     * for the supported values. `null` before `start()` resolves.
+     */
+    getSourceType(): StreamSourceType | null;
+    /**
+     * True when the broker can emit source RTP packets via
+     * `onVideoRtp` — i.e. the source is RTSP (pull) or push-rtp.
+     * RTMP and bare push (AnnexB-only) sources return false.
+     * Routing decisions in the WebRTC server (e.g. "use the H.265
+     * repacketizer") should consult this rather than string-comparing
+     * the source type.
+     */
+    isRtpSource(): boolean;
+    /**
+     * Subscribe to decoded frames. Phase 10 added `options.tag` — a short
+     * caller-identity string (`motion`, `detection`, `snapshot`,
+     * `webrtc:<sessionId>`, `benchmark`) used by `listClients` so
+     * operators can see who is holding the broker open. Omitted tag
+     * yields a `'unknown'` entry with a warn log — not silently accepted.
+     */
     onDecodedFrame(callback: (frame: DecodedFrame) => void, options?: DecodeOptions): Unsubscribe;
-    onDecodedAudioChunk(callback: (chunk: DecodedAudioChunk) => void): Unsubscribe;
+    /** Subscribe to decoded audio chunks. `options.tag` mirrors `onDecodedFrame`. */
+    onDecodedAudioChunk(callback: (chunk: DecodedAudioChunk) => void, options?: AudioSubscribeOptions): Unsubscribe;
     getStats(): BrokerStats;
     getLocalStreamUrl(): string;
+    /** Get the pre-buffer: recent encoded packets starting from last keyframe. */
+    getPreBuffer(): readonly EncodedPacket[];
+    /** Set the pre-buffer duration in seconds (0 to disable, max 30). */
+    setPreBufferDuration(seconds: number): void;
+    /** Get the current pre-buffer duration in seconds. */
+    getPreBufferDuration(): number;
+    setPreBufferEnabled(enabled: boolean): void;
 }
 /**
  * Manager for stream brokers — the server interacts with this interface,
  * while the concrete implementation lives in the addon-stream-broker package.
  */
-export interface IStreamBrokerManager {
-    createBroker(brokerId: string, source: StreamSource): Promise<IStreamBroker>;
-    getBroker(brokerId: string): IStreamBroker | undefined;
-    destroyBroker(brokerId: string): Promise<void>;
-    destroyBrokersForDevice(deviceId: string): Promise<void>;
-    listBrokers(): readonly IStreamBroker[];
-    destroyAll(): Promise<void>;
-    setRestreamers(restreamers: readonly unknown[]): void;
-    getRestreamers(): readonly unknown[];
+/** Per-broker RTSP restream entry (absorbed from the former rtsp-restream capability). */
+export interface RtspRestreamEntry {
+    readonly brokerId: string;
+    readonly url: string;
+    readonly mutedUrl: string;
+    readonly enabled: boolean;
 }
-export type CameraPriority = 'always-on' | 'default';
-export type CameraPhase = 'watching' | 'active';
+/** Flat cap-shaped broker record returned by `listBrokers()`. */
+export interface BrokerListEntry {
+    readonly brokerId: string;
+    readonly status: string;
+    readonly inputFps: number;
+    readonly decodeFps: number;
+    readonly encodedSubscribers: number;
+    readonly decodedSubscribers: number;
+    readonly uptimeMs: number;
+    readonly bitrateKbps: number;
+    readonly idrIntervalMs: number;
+    readonly codec?: string;
+    readonly totalBytes: number;
+    readonly packetCount: number;
+    readonly rtspClients: number;
+    readonly pipeClients: number;
+    readonly preBufferSec: number;
+    readonly preBufferMs: number;
+    readonly preBufferPackets: number;
+}
+/**
+ * Phase the runner's per-camera state machine occupies. `'idle'` is the
+ * `detectionMode === 'disabled'` resting state — runner registered the
+ * camera but never subscribed to detection frames. The other 4 are the
+ * historical motion-gated states; their transitions are now driven by
+ * `detectionMode` ('always-on' starts in 'active', 'on-motion' starts
+ * in 'watching').
+ */
+export type CameraPhase = 'idle' | 'watching' | 'active' | 'paused' | 'load-shed';
 export interface CameraDetectionConfig {
     readonly enabled: boolean;
-    readonly priority: CameraPriority;
-    readonly pipeline: import('../types/pipeline.js').PipelineConfig;
+    readonly pipelineEnabled: boolean;
+    /** Motion sources that activate this camera's pipeline. At least one. */
+    readonly motionSources: import('./pipeline-orchestrator-capability.js').OrchestrationMotionSources;
     readonly motionStreamId: string;
     readonly detectionStreamId: string;
     readonly motionFps: number;
     readonly detectionFps: number;
     readonly motionCooldownMs: number;
     readonly audioStreamId?: string;
+    /**
+     * Operator-facing scheduling modes. Forwarded to `RunnerCameraConfig`;
+     * the runner uses these to gate its substream subscribers + phase
+     * machine. See `PipelinePhaseMode` for the semantics.
+     */
+    readonly detectionMode: import('../device/device-profile.js').PipelinePhaseMode;
+    readonly audioMode: import('../device/device-profile.js').PipelinePhaseMode;
 }
 //# sourceMappingURL=stream-broker.d.ts.map