@ceralive/cerastream 2026.6.0-rc.2 → 2026.6.2

package/dist/constants.d.ts

@@ -8,7 +8,7 @@ export declare const PROTOCOL_VERSION: "cerastream-ipc/1";
  * additive-only within protocol major `cerastream-ipc/1` (ADR-0002 §4); this value
  * only moves when the wire schema itself does, in lockstep across both languages.
  */
-export declare const SCHEMA_VERSION: "0.1.0-stub";
+export declare const SCHEMA_VERSION: "0.3.0";
 /** Runtime dir holding both control + preview sockets. systemd `RuntimeDirectory=cerastream`. */
 export declare const DEFAULT_IPC_DIR: "/run/cerastream";
 /** Env override for the IPC dir (tests/dev). Defaults to {@link DEFAULT_IPC_DIR}. */
@@ -23,6 +23,8 @@ export declare const CONTROL_SOCKET_PATH: "/run/cerastream/control.sock";
 export declare const PREVIEW_SOCKET_PATH: "/run/cerastream/preview.sock";
 /** Per-line framing cap (ADR-0002 §1): an oversized line is a fatal protocol error. */
 export declare const MAX_LINE_BYTES: number;
+/** Upper bound (ms) for `reload-config.audio.delay_ms`. Mirrors the Rust `AUDIO_DELAY_MAX_MS` and CeraUI's `AUDIO_DELAY_MAX`. */
+export declare const AUDIO_DELAY_MAX_MS = 2000;
 /** Engine binary name (systemd-owned; CeraUI never spawns it — ADR-0005). */
 export declare const CERASTREAM_BIN: "cerastream";
 export declare const DEFAULT_MIN_BITRATE = 300;

package/dist/constants.js

@@ -11,7 +11,7 @@ export const PROTOCOL_VERSION = "cerastream-ipc/1";
  * additive-only within protocol major `cerastream-ipc/1` (ADR-0002 §4); this value
  * only moves when the wire schema itself does, in lockstep across both languages.
  */
-export const SCHEMA_VERSION = "0.1.0-stub";
+export const SCHEMA_VERSION = "0.3.0";
 /** Runtime dir holding both control + preview sockets. systemd `RuntimeDirectory=cerastream`. */
 export const DEFAULT_IPC_DIR = "/run/cerastream";
 /** Env override for the IPC dir (tests/dev). Defaults to {@link DEFAULT_IPC_DIR}. */
@@ -26,6 +26,8 @@ export const CONTROL_SOCKET_PATH = "/run/cerastream/control.sock";
 export const PREVIEW_SOCKET_PATH = "/run/cerastream/preview.sock";
 /** Per-line framing cap (ADR-0002 §1): an oversized line is a fatal protocol error. */
 export const MAX_LINE_BYTES = 1024 * 1024; // 1 MiB
+/** Upper bound (ms) for `reload-config.audio.delay_ms`. Mirrors the Rust `AUDIO_DELAY_MAX_MS` and CeraUI's `AUDIO_DELAY_MAX`. */
+export const AUDIO_DELAY_MAX_MS = 2000;
 /** Engine binary name (systemd-owned; CeraUI never spawns it — ADR-0005). */
 export const CERASTREAM_BIN = "cerastream";
 // ---- config defaults (mirror ceracoder, the engine being replaced) ----

package/dist/errors.d.ts

@@ -42,6 +42,7 @@ export declare const rpcErrorCodeSchema: z.ZodEnum<{
     "cerastream.state.not_streaming": "cerastream.state.not_streaming";
     "cerastream.state.already_streaming": "cerastream.state.already_streaming";
     "cerastream.device.not_found": "cerastream.device.not_found";
+    "cerastream.audio.device_not_found": "cerastream.audio.device_not_found";
     "cerastream.bitrate.out_of_range": "cerastream.bitrate.out_of_range";
     "cerastream.preview.unsupported_tier": "cerastream.preview.unsupported_tier";
     "cerastream.internal": "cerastream.internal";

package/dist/errors.js

@@ -60,6 +60,7 @@ export const rpcErrorCodeSchema = z.enum([
     "cerastream.state.not_streaming",
     "cerastream.state.already_streaming",
     "cerastream.device.not_found",
+    "cerastream.audio.device_not_found",
     "cerastream.bitrate.out_of_range",
     "cerastream.preview.unsupported_tier",
     "cerastream.internal",
@@ -75,6 +76,7 @@ export const RPC_ERROR_NUMERIC = {
     "cerastream.state.not_streaming": -32001,
     "cerastream.state.already_streaming": -32002,
     "cerastream.device.not_found": -32003,
+    "cerastream.audio.device_not_found": -32006,
     "cerastream.bitrate.out_of_range": -32004,
     "cerastream.preview.unsupported_tier": -32005,
     "cerastream.internal": -32603,

package/dist/events.d.ts

@@ -21,6 +21,10 @@ export declare const switchEventSchema: z.ZodObject<{
         auto: "auto";
     }>;
     reason: z.ZodOptional<z.ZodString>;
+    media_class: z.ZodOptional<z.ZodEnum<{
+        video: "video";
+        audio: "audio";
+    }>>;
 }, z.core.$strip>;
 export type SwitchEvent = z.infer<typeof switchEventSchema>;
 export declare const deviceEventSchema: z.ZodObject<{
@@ -42,6 +46,7 @@ export declare const deviceEventSchema: z.ZodObject<{
             width: z.ZodOptional<z.ZodNumber>;
             height: z.ZodOptional<z.ZodNumber>;
             framerate: z.ZodOptional<z.ZodString>;
+            media_type: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>>>;
     }, z.core.$strip>;
 }, z.core.$strip>;
@@ -108,6 +113,10 @@ export declare const eventParamsSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
         auto: "auto";
     }>;
     reason: z.ZodOptional<z.ZodString>;
+    media_class: z.ZodOptional<z.ZodEnum<{
+        video: "video";
+        audio: "audio";
+    }>>;
 }, z.core.$strip>, z.ZodObject<{
     type: z.ZodLiteral<"device">;
     seq: z.ZodNumber;
@@ -127,6 +136,7 @@ export declare const eventParamsSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
             width: z.ZodOptional<z.ZodNumber>;
             height: z.ZodOptional<z.ZodNumber>;
             framerate: z.ZodOptional<z.ZodString>;
+            media_type: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>>>;
     }, z.core.$strip>;
 }, z.core.$strip>, z.ZodObject<{
@@ -188,6 +198,10 @@ export declare const cerastreamEventSchema: z.ZodObject<{
             auto: "auto";
         }>;
         reason: z.ZodOptional<z.ZodString>;
+        media_class: z.ZodOptional<z.ZodEnum<{
+            video: "video";
+            audio: "audio";
+        }>>;
     }, z.core.$strip>, z.ZodObject<{
         type: z.ZodLiteral<"device">;
         seq: z.ZodNumber;
@@ -207,6 +221,7 @@ export declare const cerastreamEventSchema: z.ZodObject<{
                 width: z.ZodOptional<z.ZodNumber>;
                 height: z.ZodOptional<z.ZodNumber>;
                 framerate: z.ZodOptional<z.ZodString>;
+                media_type: z.ZodOptional<z.ZodString>;
             }, z.core.$strip>>>;
         }, z.core.$strip>;
     }, z.core.$strip>, z.ZodObject<{
@@ -271,6 +286,10 @@ export declare const eventSchemas: {
             auto: "auto";
         }>;
         reason: z.ZodOptional<z.ZodString>;
+        media_class: z.ZodOptional<z.ZodEnum<{
+            video: "video";
+            audio: "audio";
+        }>>;
     }, z.core.$strip>;
     readonly device: z.ZodObject<{
         type: z.ZodLiteral<"device">;
@@ -291,6 +310,7 @@ export declare const eventSchemas: {
                 width: z.ZodOptional<z.ZodNumber>;
                 height: z.ZodOptional<z.ZodNumber>;
                 framerate: z.ZodOptional<z.ZodString>;
+                media_type: z.ZodOptional<z.ZodString>;
             }, z.core.$strip>>>;
         }, z.core.$strip>;
     }, z.core.$strip>;

package/dist/events.js

@@ -1,6 +1,6 @@
 import { z } from "zod";
 import { processErrorCodeSchema, processErrorSourceSchema, } from "./errors.js";
-import { captureDeviceSchema, inputModeSchema, streamStateSchema, } from "./types.js";
+import { captureDeviceSchema, inputModeSchema, mediaClassSchema, streamStateSchema, } from "./types.js";
 // Server → client `event` notifications, delivered after `subscribe-events`
 // (schema.md "Events"). Each event is the inner `params` of an rpcEventSchema:
 // { type, seq, … }. `type` discriminates; `seq` is a per-type monotonic counter.
@@ -13,13 +13,15 @@ export const statusEventSchema = z.object({
     streaming: z.boolean(),
     active_input: z.string().optional(),
 });
-// switch — active input changed (manual or failover)
+// switch — active input changed (manual or failover). media_class is additive
+// (absent on legacy video-only emitters); switch-audio sets it to "audio".
 export const switchEventSchema = z.object({
     type: z.literal("switch"),
     seq,
     active_input: z.string(),
     mode: inputModeSchema,
     reason: z.string().optional(),
+    media_class: mediaClassSchema.optional(),
 });
 // device — GstDeviceMonitor hotplug
 export const deviceEventSchema = z.object({

package/dist/messages.d.ts

@@ -56,6 +56,9 @@ export declare const reloadConfigParamsSchema: z.ZodObject<{
     srt: z.ZodOptional<z.ZodObject<{
         latency_ms: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strip>>;
+    audio: z.ZodOptional<z.ZodObject<{
+        delay_ms: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
 }, z.core.$strip>;
 export type ReloadConfigParams = z.infer<typeof reloadConfigParamsSchema>;
 export declare const reloadConfigResultSchema: z.ZodObject<{
@@ -72,6 +75,9 @@ export declare const reloadConfigResultSchema: z.ZodObject<{
         srt: z.ZodOptional<z.ZodObject<{
             latency_ms: z.ZodOptional<z.ZodNumber>;
         }, z.core.$strip>>;
+        audio: z.ZodOptional<z.ZodObject<{
+            delay_ms: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>>;
     }, z.core.$strip>;
 }, z.core.$strip>;
 export type ReloadConfigResult = z.infer<typeof reloadConfigResultSchema>;
@@ -101,6 +107,22 @@ export declare const switchInputResultSchema: z.ZodObject<{
     }>;
 }, z.core.$strip>;
 export type SwitchInputResult = z.infer<typeof switchInputResultSchema>;
+export declare const switchAudioParamsSchema: z.ZodObject<{
+    audio_input_id: z.ZodString;
+    mode: z.ZodOptional<z.ZodEnum<{
+        manual: "manual";
+        auto: "auto";
+    }>>;
+}, z.core.$strip>;
+export type SwitchAudioParams = z.infer<typeof switchAudioParamsSchema>;
+export declare const switchAudioResultSchema: z.ZodObject<{
+    active_audio_input: z.ZodString;
+    mode: z.ZodEnum<{
+        manual: "manual";
+        auto: "auto";
+    }>;
+}, z.core.$strip>;
+export type SwitchAudioResult = z.infer<typeof switchAudioResultSchema>;
 export declare const listDevicesParamsSchema: z.ZodOptional<z.ZodObject<{
     media_class: z.ZodOptional<z.ZodEnum<{
         video: "video";
@@ -121,6 +143,7 @@ export declare const listDevicesResultSchema: z.ZodObject<{
             width: z.ZodOptional<z.ZodNumber>;
             height: z.ZodOptional<z.ZodNumber>;
             framerate: z.ZodOptional<z.ZodString>;
+            media_type: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>>>;
     }, z.core.$strip>>;
 }, z.core.$strip>;
@@ -190,6 +213,61 @@ export declare const previewSessionResultSchema: z.ZodObject<{
     }, z.core.$strip>], "kind">;
 }, z.core.$strip>;
 export type PreviewSessionResult = z.infer<typeof previewSessionResultSchema>;
+export declare const videoSourceCapSchema: z.ZodObject<{
+    id: z.ZodString;
+    supports_audio: z.ZodBoolean;
+    supports_resolution_override: z.ZodBoolean;
+    supports_framerate_override: z.ZodBoolean;
+    default_resolution: z.ZodString;
+    default_framerate: z.ZodNumber;
+}, z.core.$strip>;
+export type VideoSourceCap = z.infer<typeof videoSourceCapSchema>;
+export declare const bitrateRangeCapsSchema: z.ZodObject<{
+    min: z.ZodNumber;
+    max: z.ZodNumber;
+    unit: z.ZodString;
+}, z.core.$strip>;
+export type BitrateRangeCaps = z.infer<typeof bitrateRangeCapsSchema>;
+export declare const encoderCapsSchema: z.ZodObject<{
+    codecs: z.ZodArray<z.ZodString>;
+    bitrate_range: z.ZodObject<{
+        min: z.ZodNumber;
+        max: z.ZodNumber;
+        unit: z.ZodString;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export type EncoderCaps = z.infer<typeof encoderCapsSchema>;
+export declare const platformCapsSchema: z.ZodObject<{
+    supports_h265: z.ZodBoolean;
+    hardware_accelerated: z.ZodBoolean;
+    max_resolution: z.ZodString;
+}, z.core.$strip>;
+export type PlatformCaps = z.infer<typeof platformCapsSchema>;
+export declare const getCapabilitiesResultSchema: z.ZodObject<{
+    platform: z.ZodObject<{
+        supports_h265: z.ZodBoolean;
+        hardware_accelerated: z.ZodBoolean;
+        max_resolution: z.ZodString;
+    }, z.core.$strip>;
+    encoder: z.ZodObject<{
+        codecs: z.ZodArray<z.ZodString>;
+        bitrate_range: z.ZodObject<{
+            min: z.ZodNumber;
+            max: z.ZodNumber;
+            unit: z.ZodString;
+        }, z.core.$strip>;
+    }, z.core.$strip>;
+    sources: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        supports_audio: z.ZodBoolean;
+        supports_resolution_override: z.ZodBoolean;
+        supports_framerate_override: z.ZodBoolean;
+        default_resolution: z.ZodString;
+        default_framerate: z.ZodNumber;
+    }, z.core.$strip>>;
+    audio_live_switch: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export type GetCapabilitiesResult = z.infer<typeof getCapabilitiesResultSchema>;
 /** The eight v1 control methods (the literal JSON-RPC `method` strings). */
 export declare const V1_METHODS: readonly ["start", "stop", "reload-config", "set-bitrate", "switch-input", "list-devices", "subscribe-events", "preview-session"];
 export type V1Method = (typeof V1_METHODS)[number];
@@ -268,6 +346,9 @@ export declare const requestSchemas: {
             srt: z.ZodOptional<z.ZodObject<{
                 latency_ms: z.ZodOptional<z.ZodNumber>;
             }, z.core.$strip>>;
+            audio: z.ZodOptional<z.ZodObject<{
+                delay_ms: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$strip>>;
         }, z.core.$strip>;
         readonly result: z.ZodObject<{
             applied: z.ZodObject<{
@@ -283,6 +364,9 @@ export declare const requestSchemas: {
                 srt: z.ZodOptional<z.ZodObject<{
                     latency_ms: z.ZodOptional<z.ZodNumber>;
                 }, z.core.$strip>>;
+                audio: z.ZodOptional<z.ZodObject<{
+                    delay_ms: z.ZodOptional<z.ZodNumber>;
+                }, z.core.$strip>>;
             }, z.core.$strip>;
         }, z.core.$strip>;
     };
@@ -332,6 +416,7 @@ export declare const requestSchemas: {
                     width: z.ZodOptional<z.ZodNumber>;
                     height: z.ZodOptional<z.ZodNumber>;
                     framerate: z.ZodOptional<z.ZodString>;
+                    media_type: z.ZodOptional<z.ZodString>;
                 }, z.core.$strip>>>;
             }, z.core.$strip>>;
         }, z.core.$strip>;

package/dist/messages.js

@@ -1,4 +1,5 @@
 import { z } from "zod";
+import { AUDIO_DELAY_MAX_MS } from "./constants.js";
 import { helloParamsSchema, helloResultSchema, } from "./envelope.js";
 import { balancerAlgorithmSchema, captureDeviceSchema, cerastreamConfigSchema, inputModeSchema, mediaClassSchema, previewTierSchema, streamStateSchema, } from "./types.js";
 // The eight v1 control methods (schema.md "v1 messages"). Each is matched
@@ -34,6 +35,11 @@ export const reloadConfigParamsSchema = z.object({
         latency_ms: z.number().int().min(100).max(10_000).optional(),
     })
         .optional(),
+    audio: z
+        .object({
+        delay_ms: z.number().int().min(0).max(AUDIO_DELAY_MAX_MS).optional(),
+    })
+        .optional(),
 });
 export const reloadConfigResultSchema = z.object({
     applied: reloadConfigParamsSchema, // post-clamp values actually applied
@@ -54,6 +60,18 @@ export const switchInputResultSchema = z.object({
     active_input: z.string(),
     mode: inputModeSchema,
 });
+// ---- 5b. switch-audio (additive; the audio mirror of switch-input) ----
+// Drives the live audio fallbackswitch active-pad. Additive standalone schema
+// (like get-capabilities): kept OUT of V1_METHODS / requestSchemas so the frozen
+// eight-method contract count is unchanged. `mode` is optional (absent ⇒ manual).
+export const switchAudioParamsSchema = z.object({
+    audio_input_id: z.string(), // audio device/input identifier from list-devices
+    mode: inputModeSchema.optional(),
+});
+export const switchAudioResultSchema = z.object({
+    active_audio_input: z.string(),
+    mode: inputModeSchema,
+});
 // ---- 6. list-devices ----
 export const listDevicesParamsSchema = z
     .object({
@@ -104,6 +122,37 @@ export const previewSessionResultSchema = z.object({
         z.object({ kind: z.literal("webrtc"), sdp: z.string().optional() }),
     ]),
 });
+// ---- 9. get-capabilities ----
+// Deliberately absent from V1_METHODS / requestSchemas: it is an additive
+// standalone schema, so the frozen eight-method contract-count stays eight.
+export const videoSourceCapSchema = z.object({
+    id: z.string(),
+    supports_audio: z.boolean(),
+    supports_resolution_override: z.boolean(),
+    supports_framerate_override: z.boolean(),
+    default_resolution: z.string(),
+    default_framerate: z.number().int(),
+});
+export const bitrateRangeCapsSchema = z.object({
+    min: z.number().int(),
+    max: z.number().int(),
+    unit: z.string(), // "bps" or "kbps"
+});
+export const encoderCapsSchema = z.object({
+    codecs: z.array(z.string()),
+    bitrate_range: bitrateRangeCapsSchema,
+});
+export const platformCapsSchema = z.object({
+    supports_h265: z.boolean(),
+    hardware_accelerated: z.boolean(),
+    max_resolution: z.string(),
+});
+export const getCapabilitiesResultSchema = z.object({
+    platform: platformCapsSchema,
+    encoder: encoderCapsSchema,
+    sources: z.array(videoSourceCapSchema),
+    audio_live_switch: z.boolean().optional(),
+});
 // ---- method registry (count-assertion source of truth) ----
 /** The eight v1 control methods (the literal JSON-RPC `method` strings). */
 export const V1_METHODS = [

package/dist/types.d.ts

@@ -85,6 +85,7 @@ export declare const captureCapSchema: z.ZodObject<{
     width: z.ZodOptional<z.ZodNumber>;
     height: z.ZodOptional<z.ZodNumber>;
     framerate: z.ZodOptional<z.ZodString>;
+    media_type: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 export type CaptureCap = z.infer<typeof captureCapSchema>;
 export declare const captureDeviceSchema: z.ZodObject<{
@@ -99,6 +100,7 @@ export declare const captureDeviceSchema: z.ZodObject<{
         width: z.ZodOptional<z.ZodNumber>;
         height: z.ZodOptional<z.ZodNumber>;
         framerate: z.ZodOptional<z.ZodString>;
+        media_type: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>>;
 }, z.core.$strip>;
 export type CaptureDevice = z.infer<typeof captureDeviceSchema>;

package/dist/types.js

@@ -53,6 +53,7 @@ export const captureCapSchema = z.object({
     width: z.number().int().optional(),
     height: z.number().int().optional(),
     framerate: z.string().optional(), // e.g. "30/1"
+    media_type: z.string().optional(), // e.g. "video/x-h265"; additive, absent on legacy producers
 });
 export const captureDeviceSchema = z.object({
     input_id: z.string(), // stable id used by switch-input

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ceralive/cerastream",
-  "version": "2026.6.0-rc.2",
+  "version": "2026.6.2",
   "description": "Type-safe TypeScript schema + IPC client for the cerastream streaming engine (JSON-RPC 2.0 / NDJSON over a Unix domain socket).",
   "type": "module",
   "main": "dist/index.js",