@camstack/ui-library 1.2.234 → 1.2.236

package/dist/composites/adaptive-downlink.d.ts

@@ -61,7 +61,9 @@ export declare function shouldUpgradeAfterProbe(mbps: number): boolean;
 export declare function resolveProbeOrigin(serverUrl: string | undefined, pageOrigin: string | undefined): string | null;
 /** Which offer composed the hints. A climb and a cold start read identically
  *  in the hub's log; only the client knows which one it just sent. */
-export type AdaptiveOfferPhase = 'cold-start' | 'probe-climb' | 'renegotiate' | 'probe-refused';
+export type AdaptiveOfferPhase = 'cold-start' | 'probe-climb' | 'renegotiate' | 'probe-refused'
+/** The probe went to the session it was measured on; the hub answered (D733). */
+ | 'probe-in-session';
 /**
  * What the CLIENT sent for one adaptive decision. Deliberately not the hub's
  * verdict — the hub already logs its own pick, and a client line that repeated
@@ -80,6 +82,8 @@ export interface AdaptiveHintsReport {
     readonly prefersTier?: string;
     /** For `probe-refused`: the HTTP status the hub answered the probe with (401/429…). */
     readonly probeStatus?: number;
+    /** For `probe-in-session`: what the hub did with it — `outcome:tier:reason`. */
+    readonly probeAnswer?: string;
 }
 /**
  * Identity of a decision, for "log once per CHANGE, not per tick".
@@ -170,3 +174,31 @@ export interface DownlinkProbeStore {
 }
 /** App-wide probe cache + single-flight, one per origin. */
 export declare function createDownlinkProbe(deps: DownlinkProbeStoreDeps): DownlinkProbeStore;
+/** The hub's answer to one session's probe — `webrtcSession.applyDownlinkProbe` (D733). */
+export interface DownlinkProbeAnswer {
+    readonly outcome: 'switching' | 'held';
+    readonly tier: string | null;
+    readonly reason: string;
+}
+/** Host wiring for `webrtcSession.applyDownlinkProbe`, bound to the device. */
+export type ApplyDownlinkProbe = (sessionId: string, downlinkMbps: number) => Promise<DownlinkProbeAnswer>;
+/** What became of handing a probe to its session. */
+export type ProbeHandoff = {
+    readonly kind: 'answered';
+    readonly answer: DownlinkProbeAnswer;
+} | {
+    readonly kind: 'unsupported';
+    readonly why: 'no-wiring' | 'no-session' | 'call-failed';
+};
+/**
+ * Hand a probe to the session it was measured on (D733).
+ *
+ * The probe climb used to be a SECOND session: a make-before-break reconnect
+ * carrying `downlinkMbps`, so every adaptive live open cost two sessions. The
+ * hub now moves the open session to the probed rung itself. `answered` means
+ * the hub owns the climb, WHATEVER it answered — `held` included: a reconnect
+ * after a `held` would buy the second session for a rung the hub just refused.
+ * Only `unsupported` (no host wiring, no session id yet, or a hub that does not
+ * know the method) leaves the caller its legacy reconnect climb.
+ */
+export declare function handProbeToSession(apply: ApplyDownlinkProbe | undefined, sessionId: string | null, downlinkMbps: number): Promise<ProbeHandoff>;

package/dist/composites/agent-step-editor.d.ts

@@ -1,4 +1,5 @@
 import { PipelineAddonSchema, AgentAddonConfig, CameraStepOverridePatch } from '@camstack/types';
+import { RootModelInfo } from './root-model-source';
 export type EditorMode = 'agent' | 'device';
 export interface AgentStepEditorProps {
     readonly mode: EditorMode;
@@ -20,5 +21,10 @@ export interface AgentStepEditorProps {
      * draft, so opening + saving an un-pinned cell still leaves it inheriting.
      */
     readonly effectiveModelId?: string;
+    /**
+     * The ROOT detection model this column runs (D730). When it can supply the
+     * edited step, the editor offers "Use the root model"; absent ⇒ no offer.
+     */
+    readonly rootModel?: RootModelInfo;
 }
 export declare function AgentStepEditor(props: AgentStepEditorProps): import("react").JSX.Element;

package/dist/composites/camera-stream-player.d.ts

@@ -1,7 +1,7 @@
 import { ReactNode } from 'react';
 import { CamProfile, WebrtcSessionDebug } from '@camstack/types';
 import { ReconnectAction } from './reconnect-schedule';
-import { AdaptiveHintsReport } from './adaptive-downlink';
+import { AdaptiveHintsReport, ApplyDownlinkProbe } from './adaptive-downlink';
 import { ClientNetworkSample } from './client-network-sample';
 import { StreamDebugSample } from './stream-debug/webrtc-debug-stats.js';
 type WebkitPresentationMode = 'inline' | 'picture-in-picture' | 'fullscreen';
@@ -233,6 +233,14 @@ export interface CameraStreamPlayerProps {
      * the overlay shows its client half alone, saying so.
      */
     getSessionDebug?: (sessionId: string) => Promise<WebrtcSessionDebug>;
+    /**
+     * Hand the downlink probe to the session it was measured on
+     * (`webrtcSession.applyDownlinkProbe`, D733). The hub then moves THAT
+     * session to the probed rung — in place when it can — so a live open stays
+     * one session. Omit it (or talk to a hub that does not know the method) and
+     * the player keeps its legacy climb: a second, make-before-break session.
+     */
+    applyDownlinkProbe?: ApplyDownlinkProbe;
     /**
      * Re-offer signaling for an adaptive tier switch (client-offer mode).
      * Posts a fresh browser-built offer for an EXISTING `sessionId` against
@@ -303,4 +311,4 @@ export interface CameraStreamPlayerProps {
      */
     onVideoElement?: (el: HTMLVideoElement | null) => void;
 }
-export declare function CameraStreamPlayer({ serverUrl, streamKey, label, autoPlay, muted: initialMuted, showControls, showStats, onDebugStats, onPlaybackStats, onClientNetworkSample, probeAuthToken, onConnectTiming, className, onStateChange, onError, onReconnectAttempt, overlay, createSession, sendAnswer, handleOffer, getIceServers, addIceCandidate, getIceCandidates, closeSession, getSessionState, getSessionDebug, reoffer, posterUrl, hintsOverride, onAdaptiveHints, reconnectSignal, onControlChannel, onVideoElement, }: CameraStreamPlayerProps): import("react").JSX.Element;
+export declare function CameraStreamPlayer({ serverUrl, streamKey, label, autoPlay, muted: initialMuted, showControls, showStats, onDebugStats, onPlaybackStats, onClientNetworkSample, probeAuthToken, onConnectTiming, className, onStateChange, onError, onReconnectAttempt, overlay, createSession, sendAnswer, handleOffer, getIceServers, addIceCandidate, getIceCandidates, closeSession, getSessionState, getSessionDebug, applyDownlinkProbe, reoffer, posterUrl, hintsOverride, onAdaptiveHints, reconnectSignal, onControlChannel, onVideoElement, }: CameraStreamPlayerProps): import("react").JSX.Element;

package/dist/composites/index.d.ts

@@ -2,6 +2,8 @@ export { AddonGlobalSettingsForm } from './addon-global-settings-form';
 export type { AddonPageProps } from './addon-page-props';
 export type { AgentStepEditorProps, EditorMode } from './agent-step-editor';
 export { AgentStepEditor } from './agent-step-editor';
+export type { RootModelInfo } from './root-model-source';
+export { rootSourceState } from './root-model-source';
 export * from './app-shell';
 export type { AudioClassification, AudioClassificationListProps } from './audio-classification-list';
 export { AudioClassificationList } from './audio-classification-list';
@@ -14,7 +16,7 @@ export { BatteryBadge } from './battery-badge';
 export type { NetworkLinkBadgeProps, NetworkLinkStatusLike } from './network-link-badge';
 export { NetworkLinkBadge } from './network-link-badge';
 export * from './breadcrumb';
-export type { AdaptiveHintsReport, AdaptiveOfferPhase, } from './adaptive-downlink';
+export type { AdaptiveHintsReport, AdaptiveOfferPhase, ApplyDownlinkProbe, DownlinkProbeAnswer, } from './adaptive-downlink';
 export type { CameraStreamPlayerProps, ClientOfferResult, ClientStreamHints, PlayerConnectionState, PlayerWebrtcTarget, SessionSignalingState, SignalingResult, } from './camera-stream-player';
 export { CameraStreamPlayer } from './camera-stream-player';
 export { StreamDebugOverlay } from './stream-debug/stream-debug-overlay';

package/dist/composites/pipeline-matrix-shared.d.ts

@@ -88,12 +88,12 @@ export type CellState = {
      */
     readonly clusterWide?: boolean;
     /**
-     * The root model that already fills this step here (D715) — the step is
-     * skipped for every subject the detector names for it. Renders a
-     * "filled by <model>" chip: an enabled cell that will mostly NOT run must
-     * say so, or the operator reads its model as the one answering.
+     * The root model whose output IS this step's result here (D730) — the
+     * step's "Use the root model" flag is on and the root supplies it, so the
+     * step's own model does not run. Renders a "root" chip: an enabled cell
+     * whose model is not the one answering must say so.
      */
-    readonly filledBy?: string;
+    readonly suppliedByRoot?: string;
 } | {
     readonly kind: 'disabled';
     readonly overridden?: boolean;

package/dist/composites/root-model-source.d.ts

@@ -0,0 +1,19 @@
+import { RootStepSupply, RootSupplyState } from '@camstack/types';
+/** The root model the edited column runs, and what it can supply. */
+export interface RootModelInfo {
+    readonly modelId: string;
+    readonly name: string;
+    readonly supplies: readonly RootStepSupply[];
+}
+/** The editor's view of the flag for one step, or `null` for a step no root can supply. */
+export declare function rootSourceState(stepId: string, settings: Readonly<Record<string, unknown>> | undefined, rootModel: RootModelInfo | undefined): RootSupplyState | null;
+/** The settings bag with the flag set — every other key untouched. */
+export declare function withUseRootModel(settings: Readonly<Record<string, unknown>> | undefined, value: boolean): Readonly<Record<string, unknown>>;
+export interface RootModelSourceControlProps {
+    readonly stepId: string;
+    readonly settings: Readonly<Record<string, unknown>> | undefined;
+    readonly rootModel: RootModelInfo | undefined;
+    readonly disabled?: boolean;
+    readonly onChange: (useRootModel: boolean) => void;
+}
+export declare function RootModelSourceControl({ stepId, settings, rootModel, disabled, onChange, }: RootModelSourceControlProps): import("react").JSX.Element | null;

package/dist/composites/stream-panel.d.ts

@@ -1,5 +1,6 @@
 import { ReactNode } from 'react';
 import { CamProfile, WebrtcSessionDebug, StationaryOverlayBox } from '@camstack/types';
+import { ApplyDownlinkProbe } from './adaptive-downlink';
 import { SignalingResult, ClientOfferResult, ClientStreamHints, SessionSignalingState } from './camera-stream-player';
 import { DeviceDetections } from '../hooks/use-device-detections';
 /**
@@ -75,6 +76,8 @@ export interface StreamPanelProps {
      * that silently omits half its answer is worse than one that admits it.
      */
     readonly getSessionDebug?: (sessionId: string) => Promise<WebrtcSessionDebug>;
+    /** Hand the downlink probe to the live session (D733) — one session per open. */
+    readonly applyDownlinkProbe?: ApplyDownlinkProbe;
     /**
      * When set, the panel switches to VOD mode: it renders an `HlsVideo`
      * over this master `.m3u8` URL INSTEAD of the live WebRTC player, and
@@ -209,4 +212,4 @@ export interface StreamPanelProps {
     readonly chromeless?: boolean;
     readonly className?: string;
 }
-export declare function StreamPanel({ serverUrl, createSession, sendAnswer, handleOffer, getIceServers, addIceCandidate, getIceCandidates, closeSession, getSessionState, getSessionDebug, playbackUrl, playbackFormat, playbackAuthToken, onExitPlayback, posterUrl, streams, activeStreamId: controlledStreamId, onStreamChange, deviceName, phase, pipelineMetrics, detections, stationaryObjects, defaultShowDetections, defaultShowMotion, streamStats, autoPlay, showPlayStop, snapshotSrc, snapshotLoading, onRefreshSnapshot, showStreamStats, children, extraOverlay, ptzAvailable, ptzShown, ptzOverlay, onPtzToggle, intercomAvailable, intercomShown, onIntercomToggle, chromeless, className, }: StreamPanelProps): import("react").JSX.Element;
+export declare function StreamPanel({ serverUrl, createSession, sendAnswer, handleOffer, getIceServers, addIceCandidate, getIceCandidates, closeSession, getSessionState, getSessionDebug, applyDownlinkProbe, playbackUrl, playbackFormat, playbackAuthToken, onExitPlayback, posterUrl, streams, activeStreamId: controlledStreamId, onStreamChange, deviceName, phase, pipelineMetrics, detections, stationaryObjects, defaultShowDetections, defaultShowMotion, streamStats, autoPlay, showPlayStop, snapshotSrc, snapshotLoading, onRefreshSnapshot, showStreamStats, children, extraOverlay, ptzAvailable, ptzShown, ptzOverlay, onPtzToggle, intercomAvailable, intercomShown, onIntercomToggle, chromeless, className, }: StreamPanelProps): import("react").JSX.Element;

package/dist/generated/system-hooks.d.ts

@@ -869,6 +869,16 @@ export declare const useLocalNetworkSetNotificationEndpoint: typeof trpc.localNe
 export declare const useLocalNetworkGetViewerEndpoints: typeof trpc.localNetwork.getViewerEndpoints.useQuery;
 /** Generated alias around `trpc.localNetwork.setViewerEndpoints.useMutation`. */
 export declare const useLocalNetworkSetViewerEndpoints: typeof trpc.localNetwork.setViewerEndpoints.useMutation;
+/** Generated alias around `trpc.localNetwork.getAddresses.useQuery`. */
+export declare const useLocalNetworkGetAddresses: typeof trpc.localNetwork.getAddresses.useQuery;
+/** Generated alias around `trpc.localNetwork.addCustomAddress.useMutation`. */
+export declare const useLocalNetworkAddCustomAddress: typeof trpc.localNetwork.addCustomAddress.useMutation;
+/** Generated alias around `trpc.localNetwork.removeCustomAddress.useMutation`. */
+export declare const useLocalNetworkRemoveCustomAddress: typeof trpc.localNetwork.removeCustomAddress.useMutation;
+/** Generated alias around `trpc.localNetwork.setAddressRole.useMutation`. */
+export declare const useLocalNetworkSetAddressRole: typeof trpc.localNetwork.setAddressRole.useMutation;
+/** Generated alias around `trpc.localNetwork.getHubAddresses.useQuery`. */
+export declare const useLocalNetworkGetHubAddresses: typeof trpc.localNetwork.getHubAddresses.useQuery;
 /** Generated alias around `trpc.localNetwork.getAllowedAddresses.useQuery`. */
 export declare const useLocalNetworkGetAllowedAddresses: typeof trpc.localNetwork.getAllowedAddresses.useQuery;
 /** Generated alias around `trpc.localNetwork.setAllowedAddresses.useMutation`. */
@@ -2197,6 +2207,8 @@ export declare const useWebrtcSessionCloseSession: typeof trpc.webrtcSession.clo
 export declare const useWebrtcSessionHasAdaptiveBitrate: typeof trpc.webrtcSession.hasAdaptiveBitrate.useQuery;
 /** Generated alias around `trpc.webrtcSession.getSessionState.useQuery`. */
 export declare const useWebrtcSessionGetSessionState: typeof trpc.webrtcSession.getSessionState.useQuery;
+/** Generated alias around `trpc.webrtcSession.applyDownlinkProbe.useMutation`. */
+export declare const useWebrtcSessionApplyDownlinkProbe: typeof trpc.webrtcSession.applyDownlinkProbe.useMutation;
 /** Generated alias around `trpc.webrtcSession.getSessionDebug.useQuery`. */
 export declare const useWebrtcSessionGetSessionDebug: typeof trpc.webrtcSession.getSessionDebug.useQuery;
 /** Generated alias around `trpc.zoneAnalytics.getCurrentSnapshot.useQuery`. */

package/dist/hooks/use-device-webrtc.d.ts

@@ -1,6 +1,7 @@
 import { CamProfile, WebrtcSessionDebug } from '@camstack/types';
 import { StreamChoice } from '../composites/stream-panel';
 import { ClientStreamHints, SignalingResult, ClientOfferResult } from '../composites/camera-stream-player';
+import { ApplyDownlinkProbe, DownlinkProbeAnswer } from '../composites/adaptive-downlink';
 /**
  * Discriminated WebRTC target — same shape as `WebrtcStreamTarget` on
  * the backend cap. The `profile` tier uses the canonical `CamProfile`
@@ -120,6 +121,16 @@ export interface UseDeviceWebrtcTrpc {
             deviceId: number;
             sessionId: string;
         }, WebrtcSessionDebug>;
+        /**
+         * Hand the viewer's downlink probe to ONE live session (D733). Optional:
+         * a hub built before it has no such route, and the player then keeps its
+         * legacy probe climb (a second session).
+         */
+        applyDownlinkProbe?: MutateFn<{
+            deviceId: number;
+            sessionId: string;
+            downlinkMbps: number;
+        }, DownlinkProbeAnswer>;
     };
     pipelineOrchestrator?: {
         getCameraMetrics: QueryFn<{
@@ -201,6 +212,12 @@ export interface DeviceWebrtcResult {
      * it and shows the message.
      */
     readonly getSessionDebug: (sessionId: string) => Promise<WebrtcSessionDebug>;
+    /**
+     * Hand the downlink probe to the session it was measured on (D733). Rejects
+     * when there is no device or the hub has no such method — the player reads
+     * a rejection as "unsupported" and falls back to its legacy climb.
+     */
+    readonly applyDownlinkProbe: ApplyDownlinkProbe;
 }
 /** Live signaling state for a session — the adaptive re-offer signal. */
 export interface SessionRenegotiationState {