@camstack/types 1.2.597 → 1.2.599

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CHANGELOG.md CHANGED
@@ -7,6 +7,26 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
7
7
 
8
8
  ## [Unreleased]
9
9
 
10
+ ## [1.2.599] - 2026-11-19
11
+
12
+ ### Added
13
+
14
+ - Broker stats carry the effective encode of a derived stream (encoder, fps, GOP, bitrate target and cap, audio mode).
15
+
16
+ ### Changed
17
+
18
+ - Node inference devices report whether the default engine is excluded; stateless step refusals gain 'no-eligible-device'.
19
+ - FFmpeg rate control accepts an optional ABR target fraction on a capped encode.
20
+ - Derived-stream encode profiles accept video codec source and audio none; new DerivedEncodePreview schemas for the stream-broker previewDerivedEncode method.
21
+
22
+ ## [1.2.598] - 2026-11-18
23
+
24
+ ### Changed
25
+
26
+ - pipelineExecutor.getInferenceDeviceHealth reports an optional absentReason, and the inference device exclusion reasons gain no-gpu-device
27
+
28
+ ### Fixed
29
+
10
30
  ## [1.2.597] - 2026-11-18
11
31
 
12
32
  ### Added
@@ -53,9 +73,6 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
53
73
 
54
74
  - New device-state-refresh capability and state-refresh policy types: a provider declares how its devices are read, the hub decides when (D1062).
55
75
 
56
- ### Changed
57
-
58
-
59
76
  ## [1.2.592] - 2026-11-18
60
77
 
61
78
  ### Changed
@@ -302,8 +319,6 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
302
319
  - Notification history can show the title and body that were sent.
303
320
  - Email images travel as peerBytes tickets on smtp-provider.sendEmail.
304
321
  - A cluster update can name a server install that stalled or hit its time limit.
305
- ### Changed
306
-
307
322
  ## [1.2.562] - 2026-11-13
308
323
 
309
324
  ### Added
package/dist/addon.js CHANGED
@@ -1,5 +1,5 @@
1
1
  Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
2
- const require_runtime_capabilities = require("./runtime-capabilities-DWgr8hrq.js");
2
+ const require_runtime_capabilities = require("./runtime-capabilities-azf1ve5b.js");
3
3
  const require_event_category = require("./event-category-CMA0-jGW.js");
4
4
  const require_composed_stable_id = require("./composed-stable-id-DkF5-kuf.js");
5
5
  //#region src/generated/cap-input-defaults.ts
package/dist/addon.mjs CHANGED
@@ -1,4 +1,4 @@
1
- import { $ as CAP_STATE_LEAVES, $a as AddonMigrationsBlockedError, $i as BatchTooLargeError, $n as registerKnownSecret, A as DEVICE_SCOPED_CAPS, Ai as RECORD_CLASSES, Ba as isSecretClear, Bi as RECORD_SETTINGS_MAX_ROWS, Bn as OnBehalfSourceSchema, Ci as parseSecretPath, Ct as DEVICE_CHILDREN_BATCH_MAX, D as parseJsonUnknown, Da as createEvent, Di as secretArrayPrefixes, Ei as recordSecretRef, Et as addonPagesSourceCapability, F as createEventBusSliceSource, Fi as RECORD_MAX_DATA_BYTES, Ga as toSecretFieldView, Gi as formatSecretScope, Gn as assertTransactScope, Gr as readErrorI18n, Ha as isSecretMarker, Hi as SECRET_REF_SCHEME, Hn as ruleFireOfClaim, Hr as ErrorI18nPayloadSchema, Ht as scopeKey, Ii as RECORD_MAX_INDEXES, J as HF_REPO, Ji as normalizeSecretOwner, Jn as createSecretsAccess, Ki as globalSecretScope, Kn as resolveSecretViewsIn, Li as RECORD_MAX_INDEX_FIELDS, Lt as MODEL_FORMATS, M as createDeviceProxy, Mi as RECORD_DEFAULT_MAX_DATA_BYTES, Ni as RECORD_DELETE_BATCH, Nr as expandCapMethods, O as hfModelUrl, Oa as emitReadiness, Oi as RECORD_BATCH_MAX, P as addonSliceHandleApi, Pi as RECORD_ID_MAX_LENGTH, Qn as knownSecretCount, Ra as SECRET_CLEAR, Ri as RECORD_QUERY_MAX, Rn as CommandOriginClaimSchema, Rt as ReadinessRegistry, S as asJsonObject, Si as mapSecretLeaves, Sr as defineRecordKinds, St as deviceOpsCapability, Ti as recordSecretCollection, Tr as isZodSecret, Ua as isSecretMarkerLike, Ui as arrayItemFieldPath, Un as makeInMemoryRecords, Va as isSecretFieldView, Vi as RECORD_SWEEP_INTERVAL_MS, Vn as RuleFireOriginSchema, W as isCommand, Wa as makeSecretMarker, Wi as buildSecretRef, Wn as createRecordsAccess, X as CAP_ADVANCE_FIELDS, Xn as clearKnownSecrets, Xr as normalizeAddonInitResult, Xt as createDebugEmitter, Yi as parseSecretRef, Yn as MIN_SCRUBBED_LENGTH, Z as CAP_METHOD_TIMEOUTS_MS, Zn as forgetKnownSecret, _a as recordsErrorFromMessage, _r as RecordKindNameSchema, _t as switchRefusesSetState, aa as PlaintextSecretError, ar as PEER_BYTES_TICKET_TTL_MS, at as defineCustomActions, bi as REMOVE_LEAF, br as assertValidDeclaration, bt as MIGRATION_API_VERSION, ca as RecordSecretUnavailableError, ci as resolveDeviceSettings, cr as DATAPLANE_SECRET_HEADER, da as RecordsError, dr as defineEntryKind, dt as nodePin, ea as DeclarationRefusedError, eo as findMigrationsBlocked, er as scrubKnownSecrets, et as CAP_METHOD_NOT_IMPLEMENTED, fa as RevConflictError, fr as entryBody, ft as readCommandOrigin, ga as asRecordsError, gr as RecordKindDeclarationSchema, gt as SWITCH_SETTABLE_GATE, ha as UnknownRecordKindError, hr as RecordIndexSchema, ht as viewerUiCapability, ia as NoCallerError, ir as PEER_BYTES_STALL_MS, it as customAction, j as isDeviceScopedCap, ji as RECORD_DATABASES, k as BOOT_RECOVERY_BACKOFF_MS, ki as RECORD_BATCH_MAX_BYTES, la as RecordTooLargeError, li as resolvedValues, ma as UnindexedFilterError, mr as RecordFieldPathSchema, n as describeNvidia, na as ForeignSecretMarkerError, nr as PEER_BYTES_CHUNK_BYTES, nt as CALLER_STAMPED_CAPABILITIES, oa as RECORDS_ERROR_CODES, oi as SCOPED_SETTINGS_SCOPES, ot as describeCustomActions, pa as TransactRefusedError, pr as EntryDescriptorSchema, pt as readNodePin, qi as isSecretRef, qn as REVALIDATE_AFTER_MS, qr as BaseAddon, ra as InvalidRecordError, rr as PEER_BYTES_MAX_OUTSTANDING, rt as withoutCallerStamp, sa as RecordNotFoundError, si as nodeIdOfScopedKey, sr as CALLER_USERNAME_HEADER, ta as FilterRequiredError, tr as shortSecretRefHash, tt as isCapMethodAbsent, u as sleep, ua as RecordUniqueViolationError, ur as DisposerChain, ut as commandOrigin, vr as RecordRetentionSchema, vt as PipelineRunResultBridge, w as asString, wi as recordArrayItemPath, wr as collectZodSecretPaths, wt as adminUiCapability, xi as collectSecretLeaves, xr as declarationsOf, y as maskUrlCredentials, yi as secretViewsOf, yr as StoredRecordKindDeclarationSchema, yt as PipelineStepInputSchema, za as classifySecretWrite, zi as RECORD_SECRET_COLLECTION_PREFIX, zn as OnBehalfSchema, zt as ReadinessTimeoutError } from "./runtime-capabilities-qX7BpOYT.mjs";
1
+ import { $ as CAP_STATE_LEAVES, $i as normalizeSecretOwner, $n as createSecretsAccess, A as DEVICE_SCOPED_CAPS, Ai as recordSecretCollection, Ar as isZodSecret, Bi as RECORD_MAX_DATA_BYTES, Cr as RecordRetentionSchema, Ct as DEVICE_CHILDREN_BATCH_MAX, D as parseJsonUnknown, Di as mapSecretLeaves, Dr as defineRecordKinds, Ei as collectSecretLeaves, Er as declarationsOf, Et as addonPagesSourceCapability, F as createEventBusSliceSource, Fi as RECORD_CLASSES, Ga as isSecretClear, Gi as RECORD_SETTINGS_MAX_ROWS, Gn as OnBehalfSourceSchema, Hi as RECORD_MAX_INDEX_FIELDS, Ht as scopeKey, Ii as RECORD_DATABASES, J as HF_REPO, Ja as isSecretMarkerLike, Ji as arrayItemFieldPath, Jn as makeInMemoryRecords, Ka as isSecretFieldView, Ki as RECORD_SWEEP_INTERVAL_MS, Kn as RuleFireOriginSchema, Li as RECORD_DEFAULT_MAX_DATA_BYTES, Lt as MODEL_FORMATS, M as createDeviceProxy, Ma as createEvent, Mi as secretArrayPrefixes, Na as emitReadiness, Ni as RECORD_BATCH_MAX, O as hfModelUrl, Oi as parseSecretPath, P as addonSliceHandleApi, Pi as RECORD_BATCH_MAX_BYTES, Qi as isSecretRef, Qn as REVALIDATE_AFTER_MS, Qr as BaseAddon, Ri as RECORD_DELETE_BATCH, Rr as expandCapMethods, Rt as ReadinessRegistry, S as asJsonObject, Sa as recordsErrorFromMessage, Sr as RecordKindNameSchema, St as deviceOpsCapability, Ti as REMOVE_LEAF, Tr as assertValidDeclaration, Ua as SECRET_CLEAR, Ui as RECORD_QUERY_MAX, Un as CommandOriginClaimSchema, Vi as RECORD_MAX_INDEXES, W as isCommand, Wa as classifySecretWrite, Wi as RECORD_SECRET_COLLECTION_PREFIX, Wn as OnBehalfSchema, X as CAP_ADVANCE_FIELDS, Xa as toSecretFieldView, Xi as formatSecretScope, Xn as assertTransactScope, Xr as readErrorI18n, Xt as createDebugEmitter, Ya as makeSecretMarker, Yi as buildSecretRef, Yn as createRecordsAccess, Z as CAP_METHOD_TIMEOUTS_MS, Zi as globalSecretScope, Zn as resolveSecretViewsIn, _a as RevConflictError, _r as entryBody, _t as switchRefusesSetState, aa as DeclarationRefusedError, ao as findMigrationsBlocked, ar as scrubKnownSecrets, at as defineCustomActions, ba as UnknownRecordKindError, br as RecordIndexSchema, bt as MIGRATION_API_VERSION, ca as InvalidRecordError, cr as PEER_BYTES_MAX_OUTSTANDING, da as RECORDS_ERROR_CODES, di as SCOPED_SETTINGS_SCOPES, dt as nodePin, ea as parseSecretRef, er as MIN_SCRUBBED_LENGTH, et as CAP_METHOD_NOT_IMPLEMENTED, fa as RecordNotFoundError, fi as nodeIdOfScopedKey, fr as CALLER_USERNAME_HEADER, ft as readCommandOrigin, ga as RecordsError, gr as defineEntryKind, gt as SWITCH_SETTABLE_GATE, ha as RecordUniqueViolationError, hr as DisposerChain, ht as viewerUiCapability, ia as BatchTooLargeError, io as AddonMigrationsBlockedError, ir as registerKnownSecret, it as customAction, j as isDeviceScopedCap, ji as recordSecretRef, k as BOOT_RECOVERY_BACKOFF_MS, ki as recordArrayItemPath, kr as collectZodSecretPaths, la as NoCallerError, lr as PEER_BYTES_STALL_MS, ma as RecordTooLargeError, mi as resolvedValues, n as describeNvidia, nr as forgetKnownSecret, nt as CALLER_STAMPED_CAPABILITIES, oa as FilterRequiredError, or as shortSecretRefHash, ot as describeCustomActions, pa as RecordSecretUnavailableError, pi as resolveDeviceSettings, pr as DATAPLANE_SECRET_HEADER, pt as readNodePin, qa as isSecretMarker, qi as SECRET_REF_SCHEME, qn as ruleFireOfClaim, qr as ErrorI18nPayloadSchema, rr as knownSecretCount, rt as withoutCallerStamp, sa as ForeignSecretMarkerError, sr as PEER_BYTES_CHUNK_BYTES, ti as normalizeAddonInitResult, tr as clearKnownSecrets, tt as isCapMethodAbsent, u as sleep, ua as PlaintextSecretError, ur as PEER_BYTES_TICKET_TTL_MS, ut as commandOrigin, va as TransactRefusedError, vr as EntryDescriptorSchema, vt as PipelineRunResultBridge, w as asString, wi as secretViewsOf, wr as StoredRecordKindDeclarationSchema, wt as adminUiCapability, xa as asRecordsError, xr as RecordKindDeclarationSchema, y as maskUrlCredentials, ya as UnindexedFilterError, yr as RecordFieldPathSchema, yt as PipelineStepInputSchema, zi as RECORD_ID_MAX_LENGTH, zt as ReadinessTimeoutError } from "./runtime-capabilities-B36VcCR6.mjs";
2
2
  import { t as EventCategory } from "./event-category-7P4A3bYA.mjs";
3
3
  import { a as DeviceType, s as errMsg, t as COMPOSED_DEVICE_STABLE_ID_PREFIX } from "./composed-stable-id-DIeNz933.mjs";
4
4
  //#region src/generated/cap-input-defaults.ts
@@ -126,7 +126,7 @@ export type { AudioClassifyOutcome, AudioNotClassifiedReason, } from './schemas/
126
126
  export { AUDIO_NOT_CLASSIFIED_REASONS, AudioChunkInputSchema, AudioClassificationLabelSchema, AudioClassifyOutcomeSchema, AudioLevelSchema, BoundingBoxSchema, FrameInputSchema, SpatialDetectionSchema, } from './schemas/detection-shared.js';
127
127
  export { CameraMetricsSchema, CameraMetricsWithDeviceIdSchema, OrchestratorMetricsSchema, } from './schemas/orchestrator-metrics.js';
128
128
  export type { AudioStreamPick, CameraStream, CamProfile, CamStreamKind, DecodedAudioChunkWire, ProfileRtspEntry, ProfileSlot, ProfileSlotStatus, SubscribeAudioChunksInput, SubscribeAudioChunksResult, } from './schemas/streaming-shared.js';
129
- export { AudioChunkFormatSchema, AudioStreamPickSchema, BrokerStatsSchema, BrokerStatusSchema, CAM_PROFILE_ORDER, CameraStreamSchema, CamProfileSchema, CamStreamKindSchema, CamStreamResolutionSchema, DecodedAudioChunkSchema, FrameHandleSchema, makeProfileBrokerId, makeSourceBrokerId, ProfileRtspEntrySchema, ProfileSlotSchema, ProfileSlotStatusSchema, parseProfileBrokerId, StreamSourceEntrySchema, StreamSourceSchema, SubscribeAudioChunksInputSchema, SubscribeAudioChunksResultSchema, selectAssignedProfileSlots, } from './schemas/streaming-shared.js';
129
+ export { AudioChunkFormatSchema, AudioStreamPickSchema, BrokerStatsSchema, BrokerStatusSchema, type DerivedEffectiveEncodeStats, DerivedEffectiveEncodeSchema, DerivedSourceRefSchema, type DerivedEncodePreview, DerivedEncodePreviewSchema, type DerivedSourceProbe, DerivedSourceProbeSchema, type PreviewDerivedEncodeResult, PreviewDerivedEncodeResultSchema, CAM_PROFILE_ORDER, CameraStreamSchema, CamProfileSchema, CamStreamKindSchema, CamStreamResolutionSchema, DecodedAudioChunkSchema, FrameHandleSchema, makeProfileBrokerId, makeSourceBrokerId, ProfileRtspEntrySchema, ProfileSlotSchema, ProfileSlotStatusSchema, parseProfileBrokerId, StreamSourceEntrySchema, StreamSourceSchema, SubscribeAudioChunksInputSchema, SubscribeAudioChunksResultSchema, selectAssignedProfileSlots, } from './schemas/streaming-shared.js';
130
130
  export { buildEventKindDescriptor, EVENT_KIND_BY_CAP, EVENTFUL_CAP_NAMES, type SensorEventKindDescriptor, } from './sensor-event-kinds.js';
131
131
  export { type ClusterUpdateBlocker, ClusterUpdateBlockerSchema, clusterUpdateCapability, type ClusterUpdateFailureReason, ClusterUpdateFailureReasonSchema, type ClusterUpdateJob, ClusterUpdateJobSchema, type ClusterUpdateJobState, ClusterUpdateJobStateSchema, type ClusterUpdateOptions, ClusterUpdateOptionsSchema, type ClusterUpdatePlan, ClusterUpdatePlanSchema, type ClusterUpdateStep, type ClusterUpdateStepKind, ClusterUpdateStepKindSchema, ClusterUpdateStepSchema, type ClusterUpdateStepStatus, ClusterUpdateStepStatusSchema, type IClusterUpdateProvider, type StartClusterUpdateResult, StartClusterUpdateResultSchema, } from './cluster-update.cap.js';
132
132
  export { type ImageContract, ImageContractSchema, type ImageContractState, ImageContractStateSchema, type IServerManagementProvider, type RunnerBootCheck, RunnerBootCheckSchema, type RunnerRefusal, RunnerRefusalSchema, type ServerBootMode, ServerBootModeSchema, type ServerPackageStatus, ServerPackageStatusSchema, type ServerRollbackInfo, ServerRollbackInfoSchema, type LaunchOverrides, type SetLaunchOverridesInput, type SetLaunchOverridesResult, type ServerUpdateActionResult, ServerUpdateActionResultSchema, type ServerUpdateCheckResult, ServerUpdateCheckResultSchema, type ServerUpdateOutcome, ServerUpdateOutcomeSchema, type ServerUpdateState, ServerUpdateStateSchema, serverManagementCapability, type UpdateBlocker, UpdateBlockerSchema, type DesktopAppStatus, DesktopAppStatusSchema, type InstallDesktopUpdateReason, InstallDesktopUpdateReasonSchema, type InstallDesktopUpdateResult, InstallDesktopUpdateResultSchema, type WrapperEvidence, WrapperEvidenceSchema, type WrapperIdentity, WrapperIdentitySchema, type WrapperKind, WrapperKindSchema, } from './server-management.cap.js';
@@ -782,6 +782,9 @@ export declare const pipelineExecutorCapability: {
782
782
  since: z.ZodNumber;
783
783
  deaths: z.ZodNumber;
784
784
  lastError: z.ZodString;
785
+ absentReason: z.ZodOptional<z.ZodEnum<{
786
+ "no-gpu-device": "no-gpu-device";
787
+ }>>;
785
788
  }, z.core.$strip>>>;
786
789
  }, z.core.$strip>, import("./capability-definition.js").CapabilityMethodKind>;
787
790
  /**
@@ -586,11 +586,19 @@ declare const INFERENCE_DEVICE_EXCLUSION_REASONS: readonly [
586
586
  /** It is the CPU fallback and this node has a real accelerator serving (D215). */
587
587
  'accelerator-preferred',
588
588
  /** The camera root step is switched off on it: cluster, node or device (D1065). */
589
- 'root-switched-off'];
589
+ 'root-switched-off',
590
+ /**
591
+ * The runtime itself enumerates no such device: OpenVINO sees no supported GPU
592
+ * (the driver / compute runtime does not support this iGPU). Hardware that is
593
+ * present but cannot run — it does NOT count as an accelerator serving the
594
+ * node, so the CPU fallback is not held back for it.
595
+ */
596
+ 'no-gpu-device'];
590
597
  declare const InferenceDeviceExclusionReasonSchema: z.ZodEnum<{
591
598
  "accelerator-preferred": "accelerator-preferred";
592
599
  "cannot-host-camera-root": "cannot-host-camera-root";
593
600
  disabled: "disabled";
601
+ "no-gpu-device": "no-gpu-device";
594
602
  "root-switched-off": "root-switched-off";
595
603
  unavailable: "unavailable";
596
604
  }>;
@@ -626,6 +634,7 @@ declare const NodeInferenceDeviceSchema: z.ZodObject<{
626
634
  "accelerator-preferred": "accelerator-preferred";
627
635
  "cannot-host-camera-root": "cannot-host-camera-root";
628
636
  disabled: "disabled";
637
+ "no-gpu-device": "no-gpu-device";
629
638
  "root-switched-off": "root-switched-off";
630
639
  unavailable: "unavailable";
631
640
  }>>;
@@ -690,10 +699,12 @@ declare const NodeInferenceDevicesSchema: z.ZodObject<{
690
699
  "accelerator-preferred": "accelerator-preferred";
691
700
  "cannot-host-camera-root": "cannot-host-camera-root";
692
701
  disabled: "disabled";
702
+ "no-gpu-device": "no-gpu-device";
693
703
  "root-switched-off": "root-switched-off";
694
704
  unavailable: "unavailable";
695
705
  }>>;
696
706
  }, z.core.$strip>>>;
707
+ defaultPoolExcluded: z.ZodOptional<z.ZodBoolean>;
697
708
  }, z.core.$strip>;
698
709
  /**
699
710
  * The CLUSTER switch of one pipeline step (D1065):
@@ -1350,6 +1361,11 @@ export declare const pipelineOrchestratorCapability: {
1350
1361
  * `PipelineSettingsStore.buildNodeInferenceDevices` when placing sessions
1351
1362
  * and the per-(node,device) base provisioning via
1352
1363
  * `buildNodeInferenceDeviceSteps`.
1364
+ * `maxSessions` is a LIMIT, with one exception: when the node's default
1365
+ * pool is itself an excluded device (turned off or not functional) a
1366
+ * camera that would overflow every cap is placed over the cap on the
1367
+ * least-loaded eligible device, because the default pool must never serve
1368
+ * it (#610). The overflow is logged, naming any pin it overrode.
1353
1369
  */
1354
1370
  readonly setAgentInferenceDevices: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
1355
1371
  agentNodeId: z.ZodString;
@@ -1537,10 +1553,12 @@ export declare const pipelineOrchestratorCapability: {
1537
1553
  "accelerator-preferred": "accelerator-preferred";
1538
1554
  "cannot-host-camera-root": "cannot-host-camera-root";
1539
1555
  disabled: "disabled";
1556
+ "no-gpu-device": "no-gpu-device";
1540
1557
  "root-switched-off": "root-switched-off";
1541
1558
  unavailable: "unavailable";
1542
1559
  }>>;
1543
1560
  }, z.core.$strip>>>;
1561
+ defaultPoolExcluded: z.ZodOptional<z.ZodBoolean>;
1544
1562
  }, z.core.$strip>, import("./capability-definition.js").CapabilityMethodKind>;
1545
1563
  /**
1546
1564
  * Delete ONE stored device entry of a node — the "forget" of a device the
@@ -148,6 +148,7 @@ export type DetailResult = z.infer<typeof DetailResultSchema>;
148
148
  declare const StatelessStepRefusalSchema: z.ZodEnum<{
149
149
  "execution-failed": "execution-failed";
150
150
  "model-not-servable": "model-not-servable";
151
+ "no-eligible-device": "no-eligible-device";
151
152
  "unknown-step": "unknown-step";
152
153
  "unreadable-frame": "unreadable-frame";
153
154
  }>;
@@ -1215,6 +1216,7 @@ export declare const pipelineRunnerCapability: {
1215
1216
  reason: z.ZodEnum<{
1216
1217
  "execution-failed": "execution-failed";
1217
1218
  "model-not-servable": "model-not-servable";
1219
+ "no-eligible-device": "no-eligible-device";
1218
1220
  "unknown-step": "unknown-step";
1219
1221
  "unreadable-frame": "unreadable-frame";
1220
1222
  }>;
@@ -256,6 +256,129 @@ export declare const BrokerStatusSchema: z.ZodEnum<{
256
256
  stopped: "stopped";
257
257
  streaming: "streaming";
258
258
  }>;
259
+ /**
260
+ * The encode a derived stream's feeder was last spawned with — the read-only
261
+ * "effective encode". Read off the ffmpeg argv that runs, so it cannot drift
262
+ * from what the operator's profile and the carrier's rules resolved to.
263
+ */
264
+ export declare const DerivedEffectiveEncodeSchema: z.ZodObject<{
265
+ encoder: z.ZodNullable<z.ZodString>;
266
+ fps: z.ZodNullable<z.ZodNumber>;
267
+ gopFrames: z.ZodNumber;
268
+ targetKbps: z.ZodNullable<z.ZodNumber>;
269
+ capKbps: z.ZodNullable<z.ZodNumber>;
270
+ bufsizeKbps: z.ZodNullable<z.ZodNumber>;
271
+ audio: z.ZodEnum<{
272
+ aac: "aac";
273
+ copy: "copy";
274
+ none: "none";
275
+ profile: "profile";
276
+ }>;
277
+ }, z.core.$strip>;
278
+ export type DerivedEffectiveEncodeStats = z.infer<typeof DerivedEffectiveEncodeSchema>;
279
+ /**
280
+ * A derived stream's source: a **profile** slot (follows whatever physical
281
+ * stream that profile is assigned to) or a **camStream** (pinned to one
282
+ * physical stream regardless of assignment).
283
+ */
284
+ export declare const DerivedSourceRefSchema: z.ZodUnion<readonly [z.ZodObject<{
285
+ kind: z.ZodLiteral<"profile">;
286
+ profile: z.ZodEnum<{
287
+ high: "high";
288
+ low: "low";
289
+ mid: "mid";
290
+ }>;
291
+ }, z.core.$strip>, z.ZodObject<{
292
+ kind: z.ZodLiteral<"camStream">;
293
+ camStreamId: z.ZodString;
294
+ }, z.core.$strip>]>;
295
+ /**
296
+ * What the broker knows of a derived stream's SOURCE when it starts the
297
+ * encode. Every field is `null` when not measured — never `0`, never a guess.
298
+ */
299
+ export declare const DerivedSourceProbeSchema: z.ZodObject<{
300
+ width: z.ZodNullable<z.ZodNumber>;
301
+ height: z.ZodNullable<z.ZodNumber>;
302
+ fps: z.ZodNullable<z.ZodNumber>;
303
+ idrIntervalMs: z.ZodNullable<z.ZodNumber>;
304
+ videoCodec: z.ZodNullable<z.ZodEnum<{
305
+ h264: "h264";
306
+ h265: "h265";
307
+ }>>;
308
+ audioCodec: z.ZodNullable<z.ZodString>;
309
+ }, z.core.$strip>;
310
+ export type DerivedSourceProbe = z.infer<typeof DerivedSourceProbeSchema>;
311
+ /**
312
+ * The full effective encode of a derived-stream profile: the stats the broker
313
+ * publishes in `getBrokerStats.derivedEncode` plus the resolved geometry, the
314
+ * flags that say WHY a number differs from the request, and the ffmpeg output
315
+ * argv. One function (`computeDerivedEncode`) produces it for both the
316
+ * broker's start path and `previewDerivedEncode`.
317
+ */
318
+ export declare const DerivedEncodePreviewSchema: z.ZodObject<{
319
+ encoder: z.ZodNullable<z.ZodString>;
320
+ fps: z.ZodNullable<z.ZodNumber>;
321
+ gopFrames: z.ZodNumber;
322
+ targetKbps: z.ZodNullable<z.ZodNumber>;
323
+ capKbps: z.ZodNullable<z.ZodNumber>;
324
+ bufsizeKbps: z.ZodNullable<z.ZodNumber>;
325
+ audio: z.ZodEnum<{
326
+ aac: "aac";
327
+ copy: "copy";
328
+ none: "none";
329
+ profile: "profile";
330
+ }>;
331
+ width: z.ZodNullable<z.ZodNumber>;
332
+ height: z.ZodNullable<z.ZodNumber>;
333
+ videoCodec: z.ZodEnum<{
334
+ copy: "copy";
335
+ h264: "h264";
336
+ h265: "h265";
337
+ }>;
338
+ requestedFps: z.ZodNullable<z.ZodNumber>;
339
+ fpsClampedToSource: z.ZodBoolean;
340
+ floorKbps: z.ZodNullable<z.ZodNumber>;
341
+ raisedToFloor: z.ZodBoolean;
342
+ requestedKbps: z.ZodNullable<z.ZodNumber>;
343
+ keyframeIntervalSec: z.ZodNullable<z.ZodNumber>;
344
+ args: z.ZodArray<z.ZodString>;
345
+ }, z.core.$strip>;
346
+ export type DerivedEncodePreview = z.infer<typeof DerivedEncodePreviewSchema>;
347
+ /** Result of `previewDerivedEncode`: a plan, or the reason there is none. */
348
+ export declare const PreviewDerivedEncodeResultSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
349
+ kind: z.ZodLiteral<"preview">;
350
+ preview: z.ZodObject<{
351
+ encoder: z.ZodNullable<z.ZodString>;
352
+ fps: z.ZodNullable<z.ZodNumber>;
353
+ gopFrames: z.ZodNumber;
354
+ targetKbps: z.ZodNullable<z.ZodNumber>;
355
+ capKbps: z.ZodNullable<z.ZodNumber>;
356
+ bufsizeKbps: z.ZodNullable<z.ZodNumber>;
357
+ audio: z.ZodEnum<{
358
+ aac: "aac";
359
+ copy: "copy";
360
+ none: "none";
361
+ profile: "profile";
362
+ }>;
363
+ width: z.ZodNullable<z.ZodNumber>;
364
+ height: z.ZodNullable<z.ZodNumber>;
365
+ videoCodec: z.ZodEnum<{
366
+ copy: "copy";
367
+ h264: "h264";
368
+ h265: "h265";
369
+ }>;
370
+ requestedFps: z.ZodNullable<z.ZodNumber>;
371
+ fpsClampedToSource: z.ZodBoolean;
372
+ floorKbps: z.ZodNullable<z.ZodNumber>;
373
+ raisedToFloor: z.ZodBoolean;
374
+ requestedKbps: z.ZodNullable<z.ZodNumber>;
375
+ keyframeIntervalSec: z.ZodNullable<z.ZodNumber>;
376
+ args: z.ZodArray<z.ZodString>;
377
+ }, z.core.$strip>;
378
+ }, z.core.$strip>, z.ZodObject<{
379
+ kind: z.ZodLiteral<"no-source">;
380
+ }, z.core.$strip>], "kind">;
381
+ export type PreviewDerivedEncodeResult = z.infer<typeof PreviewDerivedEncodeResultSchema>;
259
382
  export declare const BrokerStatsSchema: z.ZodObject<{
260
383
  status: z.ZodEnum<{
261
384
  connecting: "connecting";
@@ -285,6 +408,20 @@ export declare const BrokerStatsSchema: z.ZodObject<{
285
408
  }, z.core.$strip>>>;
286
409
  audioMuted: z.ZodOptional<z.ZodBoolean>;
287
410
  audioMutedDropped: z.ZodOptional<z.ZodNumber>;
411
+ derivedEncode: z.ZodOptional<z.ZodObject<{
412
+ encoder: z.ZodNullable<z.ZodString>;
413
+ fps: z.ZodNullable<z.ZodNumber>;
414
+ gopFrames: z.ZodNumber;
415
+ targetKbps: z.ZodNullable<z.ZodNumber>;
416
+ capKbps: z.ZodNullable<z.ZodNumber>;
417
+ bufsizeKbps: z.ZodNullable<z.ZodNumber>;
418
+ audio: z.ZodEnum<{
419
+ aac: "aac";
420
+ copy: "copy";
421
+ none: "none";
422
+ profile: "profile";
423
+ }>;
424
+ }, z.core.$strip>>;
288
425
  }, z.core.$strip>;
289
426
  /**
290
427
  * Exporter-facing "profile restream" entry. Returned by
@@ -378,6 +378,7 @@ export declare const EgressEncodeSchema: z.ZodObject<{
378
378
  copy: "copy";
379
379
  h264: "h264";
380
380
  h265: "h265";
381
+ source: "source";
381
382
  }>;
382
383
  profile: z.ZodOptional<z.ZodEnum<{
383
384
  baseline: "baseline";
@@ -410,6 +411,7 @@ export declare const EgressEncodeSchema: z.ZodObject<{
410
411
  codec: z.ZodEnum<{
411
412
  aac: "aac";
412
413
  copy: "copy";
414
+ none: "none";
413
415
  opus: "opus";
414
416
  pcma: "pcma";
415
417
  pcmu: "pcmu";
@@ -450,6 +452,7 @@ export declare const EgressTranscodeRequestSchema: z.ZodObject<{
450
452
  copy: "copy";
451
453
  h264: "h264";
452
454
  h265: "h265";
455
+ source: "source";
453
456
  }>;
454
457
  profile: z.ZodOptional<z.ZodEnum<{
455
458
  baseline: "baseline";
@@ -482,6 +485,7 @@ export declare const EgressTranscodeRequestSchema: z.ZodObject<{
482
485
  codec: z.ZodEnum<{
483
486
  aac: "aac";
484
487
  copy: "copy";
488
+ none: "none";
485
489
  opus: "opus";
486
490
  pcma: "pcma";
487
491
  pcmu: "pcmu";
@@ -612,6 +616,7 @@ export declare const streamBrokerCapability: {
612
616
  copy: "copy";
613
617
  h264: "h264";
614
618
  h265: "h265";
619
+ source: "source";
615
620
  }>;
616
621
  profile: z.ZodOptional<z.ZodEnum<{
617
622
  baseline: "baseline";
@@ -644,6 +649,7 @@ export declare const streamBrokerCapability: {
644
649
  codec: z.ZodEnum<{
645
650
  aac: "aac";
646
651
  copy: "copy";
652
+ none: "none";
647
653
  opus: "opus";
648
654
  pcma: "pcma";
649
655
  pcmu: "pcmu";
@@ -930,7 +936,126 @@ export declare const streamBrokerCapability: {
930
936
  }, z.core.$strip>>>;
931
937
  audioMuted: z.ZodOptional<z.ZodBoolean>;
932
938
  audioMutedDropped: z.ZodOptional<z.ZodNumber>;
939
+ derivedEncode: z.ZodOptional<z.ZodObject<{
940
+ encoder: z.ZodNullable<z.ZodString>;
941
+ fps: z.ZodNullable<z.ZodNumber>;
942
+ gopFrames: z.ZodNumber;
943
+ targetKbps: z.ZodNullable<z.ZodNumber>;
944
+ capKbps: z.ZodNullable<z.ZodNumber>;
945
+ bufsizeKbps: z.ZodNullable<z.ZodNumber>;
946
+ audio: z.ZodEnum<{
947
+ aac: "aac";
948
+ copy: "copy";
949
+ none: "none";
950
+ profile: "profile";
951
+ }>;
952
+ }, z.core.$strip>>;
933
953
  }, z.core.$strip>, import("./capability-definition.js").CapabilityMethodKind>;
954
+ /**
955
+ * The effective encode a derived-stream `profile` WOULD run with, computed
956
+ * by the same function the broker uses when it starts the encode, against
957
+ * the source params the broker has already probed for `deviceId`. Lets an
958
+ * editor show the final geometry, fps, bitrate and ffmpeg argv live while
959
+ * the operator edits. `source` defaults to the `high` profile slot.
960
+ * `{ kind: 'no-source' }` when nothing has been probed yet — never a guess.
961
+ */
962
+ readonly previewDerivedEncode: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
963
+ deviceId: z.ZodNumber;
964
+ profile: z.ZodObject<{
965
+ video: z.ZodObject<{
966
+ codec: z.ZodEnum<{
967
+ copy: "copy";
968
+ h264: "h264";
969
+ h265: "h265";
970
+ source: "source";
971
+ }>;
972
+ profile: z.ZodOptional<z.ZodEnum<{
973
+ baseline: "baseline";
974
+ high: "high";
975
+ main: "main";
976
+ }>>;
977
+ level: z.ZodOptional<z.ZodString>;
978
+ width: z.ZodOptional<z.ZodNumber>;
979
+ height: z.ZodOptional<z.ZodNumber>;
980
+ fps: z.ZodOptional<z.ZodNumber>;
981
+ bitrateKbps: z.ZodOptional<z.ZodNumber>;
982
+ gopFrames: z.ZodOptional<z.ZodNumber>;
983
+ bf: z.ZodOptional<z.ZodNumber>;
984
+ preset: z.ZodOptional<z.ZodEnum<{
985
+ fast: "fast";
986
+ faster: "faster";
987
+ medium: "medium";
988
+ superfast: "superfast";
989
+ ultrafast: "ultrafast";
990
+ veryfast: "veryfast";
991
+ }>>;
992
+ tune: z.ZodOptional<z.ZodEnum<{
993
+ animation: "animation";
994
+ film: "film";
995
+ zerolatency: "zerolatency";
996
+ }>>;
997
+ singleSlicePerFrame: z.ZodOptional<z.ZodBoolean>;
998
+ }, z.core.$strip>;
999
+ audio: z.ZodUnion<readonly [z.ZodLiteral<"passthrough">, z.ZodObject<{
1000
+ codec: z.ZodEnum<{
1001
+ aac: "aac";
1002
+ copy: "copy";
1003
+ none: "none";
1004
+ opus: "opus";
1005
+ pcma: "pcma";
1006
+ pcmu: "pcmu";
1007
+ }>;
1008
+ bitrateKbps: z.ZodOptional<z.ZodNumber>;
1009
+ sampleRateHz: z.ZodOptional<z.ZodNumber>;
1010
+ channels: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<1>, z.ZodLiteral<2>]>>;
1011
+ }, z.core.$strip>]>;
1012
+ inputArgs: z.ZodOptional<z.ZodArray<z.ZodString>>;
1013
+ outputArgs: z.ZodOptional<z.ZodArray<z.ZodString>>;
1014
+ }, z.core.$strip>;
1015
+ source: z.ZodOptional<z.ZodUnion<readonly [z.ZodObject<{
1016
+ kind: z.ZodLiteral<"profile">;
1017
+ profile: z.ZodEnum<{
1018
+ high: "high";
1019
+ low: "low";
1020
+ mid: "mid";
1021
+ }>;
1022
+ }, z.core.$strip>, z.ZodObject<{
1023
+ kind: z.ZodLiteral<"camStream">;
1024
+ camStreamId: z.ZodString;
1025
+ }, z.core.$strip>]>>;
1026
+ }, z.core.$strip>, z.ZodDiscriminatedUnion<[z.ZodObject<{
1027
+ kind: z.ZodLiteral<"preview">;
1028
+ preview: z.ZodObject<{
1029
+ encoder: z.ZodNullable<z.ZodString>;
1030
+ fps: z.ZodNullable<z.ZodNumber>;
1031
+ gopFrames: z.ZodNumber;
1032
+ targetKbps: z.ZodNullable<z.ZodNumber>;
1033
+ capKbps: z.ZodNullable<z.ZodNumber>;
1034
+ bufsizeKbps: z.ZodNullable<z.ZodNumber>;
1035
+ audio: z.ZodEnum<{
1036
+ aac: "aac";
1037
+ copy: "copy";
1038
+ none: "none";
1039
+ profile: "profile";
1040
+ }>;
1041
+ width: z.ZodNullable<z.ZodNumber>;
1042
+ height: z.ZodNullable<z.ZodNumber>;
1043
+ videoCodec: z.ZodEnum<{
1044
+ copy: "copy";
1045
+ h264: "h264";
1046
+ h265: "h265";
1047
+ }>;
1048
+ requestedFps: z.ZodNullable<z.ZodNumber>;
1049
+ fpsClampedToSource: z.ZodBoolean;
1050
+ floorKbps: z.ZodNullable<z.ZodNumber>;
1051
+ raisedToFloor: z.ZodBoolean;
1052
+ requestedKbps: z.ZodNullable<z.ZodNumber>;
1053
+ keyframeIntervalSec: z.ZodNullable<z.ZodNumber>;
1054
+ args: z.ZodArray<z.ZodString>;
1055
+ }, z.core.$strip>;
1056
+ }, z.core.$strip>, z.ZodObject<{
1057
+ kind: z.ZodLiteral<"no-source">;
1058
+ }, z.core.$strip>], "kind">, import("./capability-definition.js").CapabilityMethodKind>;
934
1059
  /**
935
1060
  * Force a one-shot probe of a single source stream: transiently dial the
936
1061
  * broker (a `warmup` consumer), capture a fresh `BrokerStats` snapshot for
@@ -1163,6 +1288,7 @@ export declare const streamBrokerCapability: {
1163
1288
  copy: "copy";
1164
1289
  h264: "h264";
1165
1290
  h265: "h265";
1291
+ source: "source";
1166
1292
  }>;
1167
1293
  profile: z.ZodOptional<z.ZodEnum<{
1168
1294
  baseline: "baseline";
@@ -1195,6 +1321,7 @@ export declare const streamBrokerCapability: {
1195
1321
  codec: z.ZodEnum<{
1196
1322
  aac: "aac";
1197
1323
  copy: "copy";
1324
+ none: "none";
1198
1325
  opus: "opus";
1199
1326
  pcma: "pcma";
1200
1327
  pcmu: "pcmu";
package/dist/client.js CHANGED
@@ -1068,6 +1068,89 @@ var BrokerStatusSchema = zod.z.enum([
1068
1068
  "error",
1069
1069
  "stopped"
1070
1070
  ]);
1071
+ /**
1072
+ * The encode a derived stream's feeder was last spawned with — the read-only
1073
+ * "effective encode". Read off the ffmpeg argv that runs, so it cannot drift
1074
+ * from what the operator's profile and the carrier's rules resolved to.
1075
+ */
1076
+ var DerivedEffectiveEncodeSchema = zod.z.object({
1077
+ /** `-c:v` of the argv (`libx264`, a hardware encoder, `copy`); null when absent. */
1078
+ encoder: zod.z.string().nullable(),
1079
+ /** Output frame rate; null when the source cadence passes through unmeasured. */
1080
+ fps: zod.z.number().nullable(),
1081
+ gopFrames: zod.z.number(),
1082
+ /** ABR target (`-b:v`), kbps. */
1083
+ targetKbps: zod.z.number().nullable(),
1084
+ /** Ceiling (`-maxrate`), kbps. */
1085
+ capKbps: zod.z.number().nullable(),
1086
+ bufsizeKbps: zod.z.number().nullable(),
1087
+ /**
1088
+ * `copy` = source audio untouched, `aac` = re-encoded, `profile` = operator's
1089
+ * encode, `none` = the operator dropped the track.
1090
+ */
1091
+ audio: zod.z.enum([
1092
+ "copy",
1093
+ "aac",
1094
+ "profile",
1095
+ "none"
1096
+ ])
1097
+ });
1098
+ zod.z.union([zod.z.object({
1099
+ kind: zod.z.literal("profile"),
1100
+ profile: zod.z.enum([
1101
+ "high",
1102
+ "mid",
1103
+ "low"
1104
+ ])
1105
+ }), zod.z.object({
1106
+ kind: zod.z.literal("camStream"),
1107
+ camStreamId: zod.z.string()
1108
+ })]);
1109
+ zod.z.object({
1110
+ width: zod.z.number().nullable(),
1111
+ height: zod.z.number().nullable(),
1112
+ fps: zod.z.number().nullable(),
1113
+ idrIntervalMs: zod.z.number().nullable(),
1114
+ /** `h264` / `h265` when observed. */
1115
+ videoCodec: zod.z.enum(["h264", "h265"]).nullable(),
1116
+ /** Upper-cased SDP name (`AAC`, `PCMU`) when the source has an audio track. */
1117
+ audioCodec: zod.z.string().nullable()
1118
+ });
1119
+ /**
1120
+ * The full effective encode of a derived-stream profile: the stats the broker
1121
+ * publishes in `getBrokerStats.derivedEncode` plus the resolved geometry, the
1122
+ * flags that say WHY a number differs from the request, and the ffmpeg output
1123
+ * argv. One function (`computeDerivedEncode`) produces it for both the
1124
+ * broker's start path and `previewDerivedEncode`.
1125
+ */
1126
+ var DerivedEncodePreviewSchema = DerivedEffectiveEncodeSchema.extend({
1127
+ /** Final picture size; `null` when neither the profile nor the source names it. */
1128
+ width: zod.z.number().nullable(),
1129
+ height: zod.z.number().nullable(),
1130
+ /** `h264` / `h265` re-encode, `copy` remux; `null` is never returned (the encoder always resolves). */
1131
+ videoCodec: zod.z.enum([
1132
+ "h264",
1133
+ "h265",
1134
+ "copy"
1135
+ ]),
1136
+ requestedFps: zod.z.number().nullable(),
1137
+ /** The requested fps exceeded the source and the source cadence won. */
1138
+ fpsClampedToSource: zod.z.boolean(),
1139
+ /** Lowest bitrate accepted for this geometry x fps; `null` when unknown. */
1140
+ floorKbps: zod.z.number().nullable(),
1141
+ /** The explicit bitrate was below the floor and was raised to it. */
1142
+ raisedToFloor: zod.z.boolean(),
1143
+ /** What the profile asked for when it was raised; `null` otherwise. */
1144
+ requestedKbps: zod.z.number().nullable(),
1145
+ /** Seconds between keyframes; `null` when the output cadence is unknown. */
1146
+ keyframeIntervalSec: zod.z.number().nullable(),
1147
+ /** The ffmpeg argv, with the source loopback URL in `-i`. */
1148
+ args: zod.z.array(zod.z.string())
1149
+ });
1150
+ zod.z.discriminatedUnion("kind", [zod.z.object({
1151
+ kind: zod.z.literal("preview"),
1152
+ preview: DerivedEncodePreviewSchema
1153
+ }), zod.z.object({ kind: zod.z.literal("no-source") })]);
1071
1154
  zod.z.object({
1072
1155
  status: BrokerStatusSchema,
1073
1156
  inputFps: zod.z.number(),
@@ -1109,7 +1192,9 @@ zod.z.object({
1109
1192
  * alone that the mute is on the packet path and not merely persisted.
1110
1193
  */
1111
1194
  audioMuted: zod.z.boolean().optional(),
1112
- audioMutedDropped: zod.z.number().optional()
1195
+ audioMutedDropped: zod.z.number().optional(),
1196
+ /** Present for a derived broker once its feeder has spawned at least once. */
1197
+ derivedEncode: DerivedEffectiveEncodeSchema.optional()
1113
1198
  });
1114
1199
  zod.z.object({
1115
1200
  profile: CamProfileSchema,
@@ -28463,6 +28548,7 @@ function createDeviceProxy(api, binding, opts) {
28463
28548
  forgetDeviceHardware: (input, options) => dispatchSystem("streamBroker", "forgetDeviceHardware", "mutation", input, void 0, options),
28464
28549
  renderPreBufferClip: (input, options) => dispatchSystem("streamBroker", "renderPreBufferClip", "mutation", input, void 0, options),
28465
28550
  produceEventMedia: (input, options) => dispatchSystem("streamBroker", "produceEventMedia", "mutation", input, void 0, options),
28551
+ previewDerivedEncode: (input, options) => dispatchSystem("streamBroker", "previewDerivedEncode", "query", input, void 0, options),
28466
28552
  restartProfile: (input, options) => dispatchSystem("streamBroker", "restartProfile", "mutation", input, void 0, options),
28467
28553
  getDeviceAudioMute: (input, options) => dispatchSystem("streamBroker", "getDeviceAudioMute", "query", input, void 0, options),
28468
28554
  setDeviceAudioMute: (input, options) => dispatchSystem("streamBroker", "setDeviceAudioMute", "mutation", input, void 0, options),