@ceralive/cerastream 2026.9.9 → 2026.9.10

package/README.md

@@ -1,5 +1,11 @@
 # @ceralive/cerastream
 
+Prepared `2026.9.10` / schema `0.20.0` carries optional
+`active_encode.skip_to_live` alongside encoder health counters. It counts
+age-based RAM backlog discards in the current session, not outages or lost frames.
+Absence is unknown; zero is not loss-free delivery. Reconnect preserves the count,
+and session replacement resets it. Publish before consumer use.
+
 Prepared **2026.9.9 / schema 0.19.0** adds `raw_video` and `unknown` capture
 classifications. They do not promise a selectable capture mode. `camlink` remains
 unchanged for identified Elgato hardware. Publish before consumer merge: older

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.19.0';
+export declare const SCHEMA_VERSION: '0.20.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}. */

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.19.0';
+export const SCHEMA_VERSION = '0.20.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}. */

package/dist/events.d.ts

@@ -26,6 +26,9 @@ export declare const activeEncodeSchema: z.ZodObject<{
     gop_probe_ms: z.ZodOptional<z.ZodNumber>;
     frames_emitted: z.ZodOptional<z.ZodNumber>;
     pipeline_playing: z.ZodOptional<z.ZodBoolean>;
+    encoder_restarts: z.ZodOptional<z.ZodNumber>;
+    kernel_faults: z.ZodOptional<z.ZodNumber>;
+    skip_to_live: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strip>;
 export type ActiveEncode = z.infer<typeof activeEncodeSchema>;
 /**
@@ -107,6 +110,9 @@ export declare const statusEventSchema: z.ZodObject<{
         gop_probe_ms: z.ZodOptional<z.ZodNumber>;
         frames_emitted: z.ZodOptional<z.ZodNumber>;
         pipeline_playing: z.ZodOptional<z.ZodBoolean>;
+        encoder_restarts: z.ZodOptional<z.ZodNumber>;
+        kernel_faults: z.ZodOptional<z.ZodNumber>;
+        skip_to_live: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strip>>;
     preview_encoder_realized: z.ZodOptional<z.ZodObject<{
         selected_element: z.ZodOptional<z.ZodString>;
@@ -377,6 +383,9 @@ export declare const eventParamsSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
         gop_probe_ms: z.ZodOptional<z.ZodNumber>;
         frames_emitted: z.ZodOptional<z.ZodNumber>;
         pipeline_playing: z.ZodOptional<z.ZodBoolean>;
+        encoder_restarts: z.ZodOptional<z.ZodNumber>;
+        kernel_faults: z.ZodOptional<z.ZodNumber>;
+        skip_to_live: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strip>>;
     preview_encoder_realized: z.ZodOptional<z.ZodObject<{
         selected_element: z.ZodOptional<z.ZodString>;
@@ -594,6 +603,9 @@ export declare const cerastreamEventSchema: z.ZodObject<{
             gop_probe_ms: z.ZodOptional<z.ZodNumber>;
             frames_emitted: z.ZodOptional<z.ZodNumber>;
             pipeline_playing: z.ZodOptional<z.ZodBoolean>;
+            encoder_restarts: z.ZodOptional<z.ZodNumber>;
+            kernel_faults: z.ZodOptional<z.ZodNumber>;
+            skip_to_live: z.ZodOptional<z.ZodNumber>;
         }, z.core.$strip>>;
         preview_encoder_realized: z.ZodOptional<z.ZodObject<{
             selected_element: z.ZodOptional<z.ZodString>;
@@ -815,6 +827,9 @@ export declare const eventSchemas: {
             gop_probe_ms: z.ZodOptional<z.ZodNumber>;
             frames_emitted: z.ZodOptional<z.ZodNumber>;
             pipeline_playing: z.ZodOptional<z.ZodBoolean>;
+            encoder_restarts: z.ZodOptional<z.ZodNumber>;
+            kernel_faults: z.ZodOptional<z.ZodNumber>;
+            skip_to_live: z.ZodOptional<z.ZodNumber>;
         }, z.core.$strip>>;
         preview_encoder_realized: z.ZodOptional<z.ZodObject<{
             selected_element: z.ZodOptional<z.ZodString>;

package/dist/events.js

@@ -26,6 +26,9 @@ export const activeEncodeSchema = z.object({
     gop_probe_ms: z.number().int().nonnegative().optional(), // 0.5.0: GOP preflight duration in ms when a probe ran
     frames_emitted: z.number().int().nonnegative().optional(), // 0.7.0: monotonic egress-buffer counter; advances across status heartbeats while frames flow
     pipeline_playing: z.boolean().optional(), // 0.7.0: pipeline is in GStreamer PLAYING (false during an in-process reconnect)
+    encoder_restarts: z.number().int().nonnegative().optional(), // 0.20.0: bounded MPP context restarts this session (any cause); ABSENT = not asked, Some(0) = asked and clean
+    kernel_faults: z.number().int().nonnegative().optional(), // 0.20.0: the kernel-attributed subset; 0 is weak evidence — the plugin fault bridge is opt-in and ships off
+    skip_to_live: z.number().int().nonnegative().optional(),
 });
 /**
  * What this session's PREVIEW branch is actually encoding with (additive),

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@ceralive/cerastream",
-	"version": "2026.9.9",
+	"version": "2026.9.10",
 	"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",