@camstack/types 1.2.598 → 1.2.600

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,12 +7,32 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
7
7
 
8
8
  ## [Unreleased]
9
9
 
10
+ ## [1.2.600] - 2026-11-19
11
+
12
+ ### Changed
13
+
14
+ - installPythonRequirements accepts exclusiveOf: pip distributions to uninstall before the file is installed
15
+
16
+ ## [1.2.599] - 2026-11-19
17
+
18
+ ### Added
19
+
20
+ - Broker stats carry the effective encode of a derived stream (encoder, fps, GOP, bitrate target and cap, audio mode).
21
+
22
+ ### Changed
23
+
24
+ - Node inference devices report whether the default engine is excluded; stateless step refusals gain 'no-eligible-device'.
25
+ - FFmpeg rate control accepts an optional ABR target fraction on a capped encode.
26
+ - Derived-stream encode profiles accept video codec source and audio none; new DerivedEncodePreview schemas for the stream-broker previewDerivedEncode method.
27
+
10
28
  ## [1.2.598] - 2026-11-18
11
29
 
12
30
  ### Changed
13
31
 
14
32
  - pipelineExecutor.getInferenceDeviceHealth reports an optional absentReason, and the inference device exclusion reasons gain no-gpu-device
15
33
 
34
+ ### Fixed
35
+
16
36
  ## [1.2.597] - 2026-11-18
17
37
 
18
38
  ### 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';
@@ -704,6 +704,7 @@ declare const NodeInferenceDevicesSchema: z.ZodObject<{
704
704
  unavailable: "unavailable";
705
705
  }>>;
706
706
  }, z.core.$strip>>>;
707
+ defaultPoolExcluded: z.ZodOptional<z.ZodBoolean>;
707
708
  }, z.core.$strip>;
708
709
  /**
709
710
  * The CLUSTER switch of one pipeline step (D1065):
@@ -1360,6 +1361,11 @@ export declare const pipelineOrchestratorCapability: {
1360
1361
  * `PipelineSettingsStore.buildNodeInferenceDevices` when placing sessions
1361
1362
  * and the per-(node,device) base provisioning via
1362
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.
1363
1369
  */
1364
1370
  readonly setAgentInferenceDevices: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
1365
1371
  agentNodeId: z.ZodString;
@@ -1552,6 +1558,7 @@ export declare const pipelineOrchestratorCapability: {
1552
1558
  unavailable: "unavailable";
1553
1559
  }>>;
1554
1560
  }, z.core.$strip>>>;
1561
+ defaultPoolExcluded: z.ZodOptional<z.ZodBoolean>;
1555
1562
  }, z.core.$strip>, import("./capability-definition.js").CapabilityMethodKind>;
1556
1563
  /**
1557
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),