@camstack/types 1.1.31 → 1.1.33

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

@@ -82,6 +82,7 @@ export declare const RunnerFrameSourceSchema: z.ZodDiscriminatedUnion<[z.ZodObje
 }, z.core.$strip>, z.ZodObject<{
     kind: z.ZodLiteral<"remote-restream">;
     ownerNodeId: z.ZodString;
+    ownerReachableHost: z.ZodOptional<z.ZodString>;
     hubHostnameOverride: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>], "kind">;
 export type RunnerFrameSource = z.infer<typeof RunnerFrameSourceSchema>;
@@ -90,13 +91,11 @@ export type RunnerFrameSource = z.infer<typeof RunnerFrameSourceSchema>;
  * specific runner instance via `attachCamera`. Carries everything the
  * runner needs to subscribe to the local broker and execute inference.
  *
- * Stateless-pipeline model: the full pipeline content (`engine`, `steps`,
- * optional `audio`) travels with the attach payload. The runner keeps it
- * in RAM for the lifetime of the attach — on rebalance, edit, or
- * restart the orchestrator re-sends the latest snapshot.
- *
- * `engine`/`steps`/`audio` are optional during the additive migration
- * window; once orchestrator + UI are migrated they become required.
+ * Stateless-pipeline model: the pipeline content (`steps`, optional
+ * `audio`) travels with the attach payload. The runner keeps it in RAM
+ * for the lifetime of the attach — on rebalance, edit, or restart the
+ * orchestrator re-sends the latest snapshot. Engine is NOT carried: it is
+ * node-local, resolved by the executing runner at dispatch time.
  */
 declare const RunnerCameraConfigSchema: z.ZodObject<{
     deviceId: z.ZodNumber;
@@ -120,39 +119,9 @@ declare const RunnerCameraConfigSchema: z.ZodObject<{
         analyzer: "analyzer";
     }>>>;
     pipelineEnabled: z.ZodDefault<z.ZodBoolean>;
-    engine: z.ZodOptional<z.ZodObject<{
-        runtime: z.ZodEnum<{
-            node: "node";
-            python: "python";
-        }>;
-        backend: z.ZodString;
-        format: z.ZodEnum<{
-            onnx: "onnx";
-            coreml: "coreml";
-            openvino: "openvino";
-            tflite: "tflite";
-            pt: "pt";
-        }>;
-        device: z.ZodOptional<z.ZodString>;
-    }, z.core.$strip>>;
     steps: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodType<import("./pipeline-executor.cap.js").PipelineStepInputOutput, unknown, z.core.$ZodTypeInternals<import("./pipeline-executor.cap.js").PipelineStepInputOutput, unknown>>>>>;
     audio: z.ZodOptional<z.ZodNullable<z.ZodObject<{
-        engine: z.ZodObject<{
-            runtime: z.ZodEnum<{
-                node: "node";
-                python: "python";
-            }>;
-            backend: z.ZodString;
-            format: z.ZodEnum<{
-                onnx: "onnx";
-                coreml: "coreml";
-                openvino: "openvino";
-                tflite: "tflite";
-                pt: "pt";
-            }>;
-            device: z.ZodOptional<z.ZodString>;
-        }, z.core.$strip>;
-        modelId: z.ZodString;
+        modelId: z.ZodOptional<z.ZodString>;
         enabled: z.ZodBoolean;
     }, z.core.$strip>>>;
     zones: z.ZodDefault<z.ZodReadonly<z.ZodArray<z.ZodObject<{
@@ -177,6 +146,7 @@ declare const RunnerCameraConfigSchema: z.ZodObject<{
     }, z.core.$strip>, z.ZodObject<{
         kind: z.ZodLiteral<"remote-restream">;
         ownerNodeId: z.ZodString;
+        ownerReachableHost: z.ZodOptional<z.ZodString>;
         hubHostnameOverride: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>], "kind">>;
 }, z.core.$strip>;
@@ -268,39 +238,9 @@ export declare const pipelineRunnerCapability: {
                 analyzer: "analyzer";
             }>>>;
             pipelineEnabled: z.ZodDefault<z.ZodBoolean>;
-            engine: z.ZodOptional<z.ZodObject<{
-                runtime: z.ZodEnum<{
-                    node: "node";
-                    python: "python";
-                }>;
-                backend: z.ZodString;
-                format: z.ZodEnum<{
-                    onnx: "onnx";
-                    coreml: "coreml";
-                    openvino: "openvino";
-                    tflite: "tflite";
-                    pt: "pt";
-                }>;
-                device: z.ZodOptional<z.ZodString>;
-            }, z.core.$strip>>;
             steps: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodType<import("./pipeline-executor.cap.js").PipelineStepInputOutput, unknown, z.core.$ZodTypeInternals<import("./pipeline-executor.cap.js").PipelineStepInputOutput, unknown>>>>>;
             audio: z.ZodOptional<z.ZodNullable<z.ZodObject<{
-                engine: z.ZodObject<{
-                    runtime: z.ZodEnum<{
-                        node: "node";
-                        python: "python";
-                    }>;
-                    backend: z.ZodString;
-                    format: z.ZodEnum<{
-                        onnx: "onnx";
-                        coreml: "coreml";
-                        openvino: "openvino";
-                        tflite: "tflite";
-                        pt: "pt";
-                    }>;
-                    device: z.ZodOptional<z.ZodString>;
-                }, z.core.$strip>;
-                modelId: z.ZodString;
+                modelId: z.ZodOptional<z.ZodString>;
                 enabled: z.ZodBoolean;
             }, z.core.$strip>>>;
             zones: z.ZodDefault<z.ZodReadonly<z.ZodArray<z.ZodObject<{
@@ -325,6 +265,7 @@ export declare const pipelineRunnerCapability: {
             }, z.core.$strip>, z.ZodObject<{
                 kind: z.ZodLiteral<"remote-restream">;
                 ownerNodeId: z.ZodString;
+                ownerReachableHost: z.ZodOptional<z.ZodString>;
                 hubHostnameOverride: z.ZodOptional<z.ZodString>;
             }, z.core.$strip>], "kind">>;
         }, z.core.$strip>, z.ZodObject<{

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

@@ -4,9 +4,9 @@ import { DeviceType } from '../device/device-type.js';
 /**
  * A single device snapshot returned as base64 JPEG/PNG.
  *
- * Shared with the `snapshot-provider` collection cap — the orchestrator
- * receives the same shape from each native provider and from the
- * broker-based fallback.
+ * The `SnapshotAddon` wrapper returns this shape whether the frame came from
+ * the device-native provider (onboard capture) or from the stream-broker
+ * prebuffer fallback.
  */
 declare const SnapshotImageSchema: z.ZodObject<{
     base64: z.ZodString;

package/dist/capabilities/stream-broker.cap.d.ts

@@ -1,5 +1,13 @@
 import { z } from 'zod';
 import { type InferProvider } from './capability-definition.js';
+/** Stream delivery format. (Relocated from the retired `streaming-engine` cap.) */
+export declare const StreamFormatSchema: z.ZodEnum<{
+    rtsp: "rtsp";
+    webrtc: "webrtc";
+    hls: "hls";
+    mjpeg: "mjpeg";
+}>;
+export type StreamFormat = z.infer<typeof StreamFormatSchema>;
 declare const RtspRestreamEntrySchema: z.ZodObject<{
     brokerId: z.ZodString;
     url: z.ZodString;
@@ -320,11 +328,11 @@ export declare const streamBrokerCapability: {
                     gopFrames: z.ZodOptional<z.ZodNumber>;
                     bf: z.ZodOptional<z.ZodNumber>;
                     preset: z.ZodOptional<z.ZodEnum<{
+                        fast: "fast";
                         ultrafast: "ultrafast";
                         superfast: "superfast";
                         veryfast: "veryfast";
                         faster: "faster";
-                        fast: "fast";
                         medium: "medium";
                     }>>;
                     tune: z.ZodOptional<z.ZodEnum<{

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

@@ -82,7 +82,7 @@ export declare const systemCapability: {
     };
     /** BIG PLAN 2: declarative mount hint — read by `@camstack/system` `buildCapRouters`. */
     readonly mount: {
-        readonly kind: "service-backed";
+        readonly kind: "server-provided";
     };
 };
 export type ISystemProvider = InferProvider<typeof systemCapability>;

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

@@ -52,7 +52,7 @@ export declare const toastCapability: {
     };
     /** BIG PLAN 2: declarative mount hint — read by `@camstack/system` `buildCapRouters`. */
     readonly mount: {
-        readonly kind: "service-backed";
+        readonly kind: "server-provided";
     };
 };
 export type IToastProvider = InferProvider<typeof toastCapability>;

package/dist/capabilities/webrtc-session.cap.d.ts

@@ -1,6 +1,20 @@
 import { z } from 'zod';
 import { type InferProvider } from './capability-definition.js';
 import { DeviceType } from '../device/device-type.js';
+/**
+ * Optional client-side hints sent at session creation to help the provider
+ * pick the best native source. All fields optional — a viewer that knows
+ * nothing still gets a sane default. (Relocated from the retired `webrtc`
+ * collection cap; this `webrtc-session` cap is the live signaling surface.)
+ */
+export declare const webrtcClientHintsSchema: z.ZodObject<{
+    viewportWidth: z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
+    viewportHeight: z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
+    devicePixelRatio: z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
+    downlinkMbps: z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
+    prefersTier: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+}, z.core.$strip>;
+export type WebrtcClientHints = z.infer<typeof webrtcClientHintsSchema>;
 /**
  * Discriminated target for a WebRTC session. The client sends this
  * structured object instead of building / parsing brokerId strings;
@@ -342,7 +356,7 @@ export declare const webrtcSessionCapability: {
     };
     /** BIG PLAN 2: declarative mount hint — read by `@camstack/system` `buildCapRouters`. */
     readonly mount: {
-        readonly kind: "custom";
+        readonly kind: "server-provided";
     };
 };
 export type IWebrtcSessionProvider = InferProvider<typeof webrtcSessionCapability>;

package/dist/encode-profile.d.ts

@@ -29,11 +29,11 @@ export declare const VideoEncodeSchema: z.ZodObject<{
     gopFrames: z.ZodOptional<z.ZodNumber>;
     bf: z.ZodOptional<z.ZodNumber>;
     preset: z.ZodOptional<z.ZodEnum<{
+        fast: "fast";
         ultrafast: "ultrafast";
         superfast: "superfast";
         veryfast: "veryfast";
         faster: "faster";
-        fast: "fast";
         medium: "medium";
     }>>;
     tune: z.ZodOptional<z.ZodEnum<{
@@ -75,11 +75,11 @@ export declare const EncodeProfileSchema: z.ZodObject<{
         gopFrames: z.ZodOptional<z.ZodNumber>;
         bf: z.ZodOptional<z.ZodNumber>;
         preset: z.ZodOptional<z.ZodEnum<{
+            fast: "fast";
             ultrafast: "ultrafast";
             superfast: "superfast";
             veryfast: "veryfast";
             faster: "faster";
-            fast: "fast";
             medium: "medium";
         }>>;
         tune: z.ZodOptional<z.ZodEnum<{

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

@@ -182,6 +182,18 @@ export declare enum EventCategory {
      * `DeviceStreamsRegistered` cycle.
      */
     PipelineCameraUpdated = "pipeline.camera-updated",
+    /**
+     * The cluster camera-source OWNER changed (`clusterRoles.ingestNode`).
+     * Emitted by addon-pipeline-orchestrator whenever it (re)derives node
+     * capabilities — at boot, on agent online/offline, and on an ingest-node
+     * flip. Carries the resolved `ownerNodeId`. The stream-broker consumes it to
+     * keep its ingest-owner-gate decision current WITHOUT a per-`ensureBroker`
+     * cross-process `getIngestOwner` query (push the authority's decision instead
+     * of polling it on the hot path). Idempotent state — re-emitted on every
+     * topology change, so a dropped event self-heals on the next one (plus the
+     * broker's long backstop reconcile query).
+     */
+    PipelineIngestOwnerChanged = "pipeline.ingest-owner-changed",
     /**
      * Periodic snapshot of per-node pipeline-runner load
      * (`RunnerLocalLoad`). Emitted ~1Hz by every runner so UI dashboards