@camstack/addon-post-analysis 1.1.23 → 1.1.25

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.
@@ -4627,7 +4627,7 @@ function _instanceof(cls, params = {}) {
4627
4627
  return inst;
4628
4628
  }
4629
4629
  //#endregion
4630
- //#region ../types/dist/sleep-CZDdRBua.mjs
4630
+ //#region ../types/dist/sleep-b4Jf2n33.mjs
4631
4631
  var EventCategory = /* @__PURE__ */ function(EventCategory) {
4632
4632
  EventCategory["SystemBoot"] = "system.boot";
4633
4633
  EventCategory["SystemAddonsReady"] = "system.addons-ready";
@@ -4813,6 +4813,18 @@ var EventCategory = /* @__PURE__ */ function(EventCategory) {
4813
4813
  */
4814
4814
  EventCategory["PipelineCameraUpdated"] = "pipeline.camera-updated";
4815
4815
  /**
4816
+ * The cluster camera-source OWNER changed (`clusterRoles.ingestNode`).
4817
+ * Emitted by addon-pipeline-orchestrator whenever it (re)derives node
4818
+ * capabilities — at boot, on agent online/offline, and on an ingest-node
4819
+ * flip. Carries the resolved `ownerNodeId`. The stream-broker consumes it to
4820
+ * keep its ingest-owner-gate decision current WITHOUT a per-`ensureBroker`
4821
+ * cross-process `getIngestOwner` query (push the authority's decision instead
4822
+ * of polling it on the hot path). Idempotent state — re-emitted on every
4823
+ * topology change, so a dropped event self-heals on the next one (plus the
4824
+ * broker's long backstop reconcile query).
4825
+ */
4826
+ EventCategory["PipelineIngestOwnerChanged"] = "pipeline.ingest-owner-changed";
4827
+ /**
4816
4828
  * Periodic snapshot of per-node pipeline-runner load
4817
4829
  * (`RunnerLocalLoad`). Emitted ~1Hz by every runner so UI dashboards
4818
4830
  * subscribe instead of polling `pipelineRunner.getLocalLoad`.
@@ -5336,10 +5348,6 @@ function hydrateField(field, values) {
5336
5348
  };
5337
5349
  }
5338
5350
  const rawValue = storedValue !== void 0 ? storedValue : defaultValue !== void 0 ? defaultValue : null;
5339
- if (field.type === "password") return {
5340
- ...field,
5341
- value: ""
5342
- };
5343
5351
  const value = field.type === "textarea" && field.isJson && rawValue !== null && typeof rawValue === "object" ? JSON.stringify(rawValue, null, 2) : rawValue;
5344
5352
  return {
5345
5353
  ...field,
@@ -6728,6 +6736,21 @@ function method(input, output, options) {
6728
6736
  timeoutMs: options?.timeoutMs
6729
6737
  };
6730
6738
  }
6739
+ /**
6740
+ * A wrapper/system-only method: served exclusively by the cap's system-level
6741
+ * provider (`InferProvider`), and OPTIONAL on `InferNativeProvider` so per-device
6742
+ * driver natives don't stub out a wrapper concern (e.g. a cross-device cache
6743
+ * overview). The `systemOnly: true` literal is what `InferNativeProvider` keys on.
6744
+ */
6745
+ function systemMethod(input, output, options) {
6746
+ return {
6747
+ ...method(input, output, options),
6748
+ systemOnly: true
6749
+ };
6750
+ }
6751
+ var StaticDirOutputSchema$1 = object({ staticDir: string() });
6752
+ var VersionOutputSchema$1 = object({ version: string() });
6753
+ method(_void(), StaticDirOutputSchema$1), method(_void(), VersionOutputSchema$1);
6731
6754
  var StaticDirOutputSchema = object({ staticDir: string() });
6732
6755
  var VersionOutputSchema = object({ version: string() });
6733
6756
  method(_void(), StaticDirOutputSchema), method(_void(), VersionOutputSchema);
@@ -6909,6 +6932,36 @@ var ModelFormatsSchema = object({
6909
6932
  tflite: ModelFormatEntrySchema.optional(),
6910
6933
  pt: ModelFormatEntrySchema.optional()
6911
6934
  });
6935
+ /**
6936
+ * Variant-selector grouping axes. Shared by the full `ModelCatalogEntry` and by
6937
+ * the reduced `PipelineModelOption` returned in `pipeline.getSchema()` so the
6938
+ * grouped Family→Tier→Variant picker renders identically in the config UI and
6939
+ * in the pipeline/device steppers. The flat `id` stays the source of truth for
6940
+ * resolution/download/persistence; this is a presentation overlay resolved back
6941
+ * to an `id`.
6942
+ */
6943
+ var ModelVariantGroupSchema = object({
6944
+ /** Top-level family, e.g. `yolo26` (later `d-fine`, `rf-detr`). */
6945
+ family: string(),
6946
+ /** Size within the family, e.g. `n` | `s` | `m` | `l`. */
6947
+ tier: string(),
6948
+ /** Quantization axis. Omit ⇒ the fp32 base build. */
6949
+ precision: _enum(["fp32", "int8"]).optional(),
6950
+ /**
6951
+ * Speed-optimization axis. Omit ⇒ the standard build. `fast` marks a
6952
+ * latency-optimized export (e.g. ReLU-activation variant) — the slot the
6953
+ * future performance variants plug into.
6954
+ */
6955
+ optimization: _enum(["standard", "fast"]).optional(),
6956
+ /**
6957
+ * Input-resolution axis (square input side, px). Omit ⇒ the family's native
6958
+ * resolution (640 for yolo26). Reduced-input builds (320 / 256) are a big,
6959
+ * cheap latency lever — especially on Apple ANE and the Intel N100 — at a
6960
+ * small-object accuracy cost. Mirrors the model's `inputSize` but lifted onto
6961
+ * the group so the selector can offer it as a variant axis.
6962
+ */
6963
+ resolution: number().int().positive().optional()
6964
+ });
6912
6965
  var ModelCatalogEntrySchema = object({
6913
6966
  id: string(),
6914
6967
  name: string(),
@@ -6938,7 +6991,43 @@ var ModelCatalogEntrySchema = object({
6938
6991
  * Auxiliary files required at runtime (labels JSON, charset dict, etc.).
6939
6992
  * Downloaded into the same modelsDir alongside the model file.
6940
6993
  */
6941
- extraFiles: array(ModelExtraFileSchema).readonly().optional()
6994
+ extraFiles: array(ModelExtraFileSchema).readonly().optional(),
6995
+ /**
6996
+ * LEGACY entry — retained in the catalog so a persisted operator selection
6997
+ * still RESOLVES (and can be re-activated), but hidden from the selectable
6998
+ * model list and excluded from the auto format-default pick. Set on the
6999
+ * superseded / consolidated models (older lineages, redundant fp16 IRs) so
7000
+ * the active lineup stays the coherent curated ladder without deleting a
7001
+ * model anyone may still be pinned to. `resolveModelForFormat` keeps honoring
7002
+ * an explicit legacy id that has a build for the node's format.
7003
+ */
7004
+ legacy: boolean().optional(),
7005
+ /**
7006
+ * Measured quality/latency metadata — populated from the benchmark addon on
7007
+ * the real node classes. Absent = not yet measured (most entries today; the
7008
+ * catalog historically carried only `sizeMB`, a poor cross-architecture
7009
+ * speed proxy). `p95LatencyMs` is keyed by node class (e.g. `n100`, `mac`).
7010
+ */
7011
+ metrics: object({
7012
+ map50: number().optional(),
7013
+ p95LatencyMs: record(string(), number()).optional()
7014
+ }).optional(),
7015
+ /**
7016
+ * SPDX-ish license id of the model weights (e.g. `AGPL-3.0` for Ultralytics
7017
+ * YOLO26, `GPL-3.0` for YOLOv9, `Apache-2.0` for D-FINE/RF-DETR). Matters for
7018
+ * the retraining addon and any future commercial distribution.
7019
+ */
7020
+ license: string().optional(),
7021
+ /**
7022
+ * Variant-selector grouping. The UI groups models by `family` + `tier` and
7023
+ * offers `precision` / `optimization` as variant axes WITHIN a tier — so all
7024
+ * of a family's sizes and quantizations collapse into one grouped picker
7025
+ * instead of a flat list of `yolo26s`, `yolo26s-int8`, … Absent ⇒ ungrouped
7026
+ * (legacy / custom models) — never shown in the grouped selector. The flat
7027
+ * `id` stays the source of truth for resolution/download/persistence; grouping
7028
+ * is a presentation overlay resolved back to an `id`.
7029
+ */
7030
+ group: ModelVariantGroupSchema.optional()
6942
7031
  });
6943
7032
  var ConvertTargetSchema = discriminatedUnion("format", [object({
6944
7033
  format: literal("openvino"),
@@ -7018,8 +7107,8 @@ var RecordingModeSchema = _enum([
7018
7107
  "onAudioThreshold"
7019
7108
  ]);
7020
7109
  /**
7021
- * First-class, authoritative per-camera storage mode — the netta choice the UI
7022
- * reads directly (never inferred from `rules`):
7110
+ * First-class, authoritative per-camera storage mode — the explicit choice the
7111
+ * UI reads directly (never inferred from `rules`):
7023
7112
  * - `off` — not recording.
7024
7113
  * - `events` — record only around triggers (motion / audio threshold),
7025
7114
  * with pre/post-buffer.
@@ -8713,26 +8802,13 @@ DeviceType.Light, method(object({
8713
8802
  percentage: number().min(0).max(100),
8714
8803
  lastChangedAt: number()
8715
8804
  });
8805
+ /** Stream delivery format. (Relocated from the retired `streaming-engine` cap.) */
8716
8806
  var StreamFormatSchema = _enum([
8717
8807
  "webrtc",
8718
8808
  "hls",
8719
8809
  "mjpeg",
8720
8810
  "rtsp"
8721
8811
  ]);
8722
- var StreamInfoSchema = object({
8723
- streamId: string(),
8724
- format: StreamFormatSchema,
8725
- url: string().nullable(),
8726
- active: boolean()
8727
- });
8728
- method(object({
8729
- streamId: string(),
8730
- sourceUrl: string(),
8731
- codec: string().optional()
8732
- }), _void(), { kind: "mutation" }), method(object({ streamId: string() }), _void(), { kind: "mutation" }), method(object({
8733
- streamId: string(),
8734
- format: StreamFormatSchema
8735
- }), string().nullable()), method(_void(), array(StreamInfoSchema));
8736
8812
  var RtspRestreamEntrySchema = object({
8737
8813
  brokerId: string(),
8738
8814
  url: string(),
@@ -9397,7 +9473,7 @@ var ConsumablesStatusSchema = object({
9397
9473
  })),
9398
9474
  lastChangedAt: number()
9399
9475
  });
9400
- DeviceType.Camera, DeviceType.Hub, DeviceType.Light, DeviceType.Siren, DeviceType.Switch, DeviceType.Sensor, DeviceType.Thermostat, DeviceType.Button, DeviceType.EventEmitter, DeviceType.Update, DeviceType.Generic, DeviceType.Notifier, DeviceType.Script, DeviceType.Automation, DeviceType.Lock, DeviceType.Cover, DeviceType.Valve, DeviceType.Humidifier, DeviceType.WaterHeater, DeviceType.Fan, DeviceType.MediaPlayer, DeviceType.AlarmPanel, DeviceType.Control, DeviceType.Presence, DeviceType.Weather, DeviceType.Vacuum, DeviceType.LawnMower, DeviceType.Container, DeviceType.Image, method(object({
9476
+ Object.values(DeviceType), method(object({
9401
9477
  deviceId: number().int().nonnegative(),
9402
9478
  key: string().min(1)
9403
9479
  }), _void(), {
@@ -10312,7 +10388,7 @@ var BoundingBoxSchema = object({
10312
10388
  w: number(),
10313
10389
  h: number()
10314
10390
  });
10315
- var SpatialDetectionSchema = object({
10391
+ object({
10316
10392
  class: string(),
10317
10393
  originalClass: string(),
10318
10394
  score: number(),
@@ -10447,7 +10523,6 @@ var PipelineDefaultStepSchema = lazy(() => object({
10447
10523
  enabled: boolean(),
10448
10524
  modelId: string(),
10449
10525
  children: array(PipelineDefaultStepSchema).readonly(),
10450
- engine: PipelineEngineChoiceSchema.optional(),
10451
10526
  group: string().optional(),
10452
10527
  settings: record(string(), unknown()).optional()
10453
10528
  }));
@@ -10472,7 +10547,9 @@ var PipelineModelOptionSchema = object({
10472
10547
  formats: record(string(), object({
10473
10548
  downloaded: boolean(),
10474
10549
  sizeMB: number()
10475
- }))
10550
+ })),
10551
+ group: ModelVariantGroupSchema.optional(),
10552
+ legacy: boolean().optional()
10476
10553
  });
10477
10554
  var ConfigFieldBridge = custom();
10478
10555
  var PipelineAddonSchemaSchema = object({
@@ -10486,6 +10563,7 @@ var PipelineAddonSchemaSchema = object({
10486
10563
  defaultModelId: string(),
10487
10564
  defaultModelIdByFormat: record(string(), string()).optional(),
10488
10565
  enabledByDefault: boolean().optional(),
10566
+ backfillIntoExistingOverrides: boolean().optional(),
10489
10567
  defaultConfidence: number(),
10490
10568
  group: string().optional(),
10491
10569
  configSchema: array(ConfigFieldBridge).readonly().optional()
@@ -10502,11 +10580,6 @@ var PipelineSchemaSchema = object({
10502
10580
  selectedEngine: PipelineEngineChoiceSchema,
10503
10581
  slots: array(PipelineSlotSchemaSchema).readonly()
10504
10582
  });
10505
- var DetectorOutputSchema = object({
10506
- detections: array(SpatialDetectionSchema).readonly(),
10507
- inferenceMs: number(),
10508
- modelId: string()
10509
- });
10510
10583
  var EngineProvisioningSchema = object({
10511
10584
  runtimeId: _enum([
10512
10585
  "onnx",
@@ -10523,15 +10596,42 @@ var EngineProvisioningSchema = object({
10523
10596
  ]),
10524
10597
  progress: number().optional(),
10525
10598
  error: string().optional(),
10526
- nextRetryAt: number().optional()
10599
+ nextRetryAt: number().optional(),
10600
+ /**
10601
+ * Gate A (config-correctness gate at engine change): human-readable
10602
+ * config issues surfaced EAGERLY when the node's engine changes — model
10603
+ * substitutions ("chose X, running Y") and zero-build steps ("no model
10604
+ * has a <format> build"). Additive/optional: informational only, never
10605
+ * enforced here — `assertEngineReady` (readiness) still gates inference.
10606
+ * Absent/empty when the node-default tree resolves cleanly.
10607
+ */
10608
+ configIssues: array(string()).optional()
10527
10609
  });
10528
10610
  var PipelineStepInputSchema = lazy(() => object({
10529
10611
  addonId: string(),
10530
- modelId: string(),
10612
+ modelId: string().optional(),
10531
10613
  enabled: boolean().default(true),
10532
10614
  children: array(PipelineStepInputSchema).optional(),
10533
10615
  settings: record(string(), unknown()).optional()
10534
10616
  }));
10617
+ var ModelSubstitutionSchema = object({
10618
+ addonId: string(),
10619
+ chosen: string(),
10620
+ running: string(),
10621
+ format: string()
10622
+ });
10623
+ var PipelineValidationIssueSchema = object({
10624
+ addonId: string(),
10625
+ kind: _enum(["unknown-addon", "no-format-build"]),
10626
+ detail: string()
10627
+ });
10628
+ var PipelineValidationResultSchema = object({
10629
+ ok: boolean(),
10630
+ issues: array(PipelineValidationIssueSchema).readonly(),
10631
+ substitutions: array(ModelSubstitutionSchema).readonly(),
10632
+ /** The node's `currentEngine.format` this validation ran against. */
10633
+ format: string()
10634
+ });
10535
10635
  var ReferenceImageEntrySchema = object({
10536
10636
  filename: string(),
10537
10637
  stepIds: array(string()).readonly().optional()
@@ -10602,7 +10702,13 @@ method(_void(), array(PipelineEngineChoiceSchema)), method(_void(), PipelineEngi
10602
10702
  })) }), object({ success: literal(true) }), {
10603
10703
  kind: "mutation",
10604
10704
  auth: "admin"
10605
- }), method(_void(), PipelineSchemaSchema), method(_void(), array(PipelineDefaultStepSchema).readonly().nullable()), method(_void(), PipelineConfigBridge), method(_void(), ConfigUISchemaBridge), method(_void(), array(PipelineTemplateSchema$1).readonly()), method(object({
10705
+ }), method(object({ nodeId: string() }), object({
10706
+ success: literal(true),
10707
+ clearedDevices: number()
10708
+ }), {
10709
+ kind: "mutation",
10710
+ auth: "admin"
10711
+ }), method(_void(), PipelineSchemaSchema), method(_void(), array(PipelineDefaultStepSchema).readonly().nullable()), method(_void(), PipelineConfigBridge), method(_void(), ConfigUISchemaBridge), method(object({ steps: array(PipelineStepInputSchema) }), PipelineValidationResultSchema), method(_void(), array(PipelineTemplateSchema$1).readonly()), method(object({
10606
10712
  name: string(),
10607
10713
  steps: array(PipelineTemplateStepSchema).readonly(),
10608
10714
  engine: PipelineEngineChoiceSchema
@@ -10619,10 +10725,6 @@ method(_void(), array(PipelineEngineChoiceSchema)), method(_void(), PipelineEngi
10619
10725
  modelId: string(),
10620
10726
  format: ModelFormatSchema$1
10621
10727
  }), object({ success: literal(true) }), { kind: "mutation" }), method(object({
10622
- addonId: string(),
10623
- frame: FrameInputSchema,
10624
- config: record(string(), unknown()).optional()
10625
- }), DetectorOutputSchema), method(object({
10626
10728
  engine: PipelineEngineChoiceSchema.optional(),
10627
10729
  steps: array(PipelineStepInputSchema).min(1),
10628
10730
  frame: FrameInputSchema.optional(),
@@ -10862,6 +10964,13 @@ var RunnerFrameSourceSchema = discriminatedUnion("kind", [object({ kind: literal
10862
10964
  kind: literal("remote-restream"),
10863
10965
  /** The camera's source-owner node (slice 1: always the hub). */
10864
10966
  ownerNodeId: string(),
10967
+ /**
10968
+ * The owner's LAN-reachable host, resolved by the orchestrator from the
10969
+ * per-node `reachableHost` override (Cluster UI). When present the runner
10970
+ * dials THIS host for the owner's restream, in preference to the
10971
+ * `CAMSTACK_HUB_URL`-derived default. Absent → auto-detect fallback.
10972
+ */
10973
+ ownerReachableHost: string().optional(),
10865
10974
  /** Operator override for the owner host the runner dials. */
10866
10975
  hubHostnameOverride: string().optional()
10867
10976
  })]).describe("Per-camera frame-source mode for the runner (P2c)");
@@ -10870,13 +10979,11 @@ var RunnerFrameSourceSchema = discriminatedUnion("kind", [object({ kind: literal
10870
10979
  * specific runner instance via `attachCamera`. Carries everything the
10871
10980
  * runner needs to subscribe to the local broker and execute inference.
10872
10981
  *
10873
- * Stateless-pipeline model: the full pipeline content (`engine`, `steps`,
10874
- * optional `audio`) travels with the attach payload. The runner keeps it
10875
- * in RAM for the lifetime of the attach — on rebalance, edit, or
10876
- * restart the orchestrator re-sends the latest snapshot.
10877
- *
10878
- * `engine`/`steps`/`audio` are optional during the additive migration
10879
- * window; once orchestrator + UI are migrated they become required.
10982
+ * Stateless-pipeline model: the pipeline content (`steps`, optional
10983
+ * `audio`) travels with the attach payload. The runner keeps it in RAM
10984
+ * for the lifetime of the attach — on rebalance, edit, or restart the
10985
+ * orchestrator re-sends the latest snapshot. Engine is NOT carried: it is
10986
+ * node-local, resolved by the executing runner at dispatch time.
10880
10987
  */
10881
10988
  var RunnerCameraConfigSchema = object({
10882
10989
  deviceId: number(),
@@ -10927,14 +11034,11 @@ var RunnerCameraConfigSchema = object({
10927
11034
  */
10928
11035
  motionSources: MotionSourcesSchema.default(["analyzer"]),
10929
11036
  pipelineEnabled: boolean().default(true),
10930
- /** Engine choice for video steps (runtime+backend+format). */
10931
- engine: PipelineEngineChoiceSchema.optional(),
10932
11037
  /** Ordered tree of video steps. Absent → runner skips video detection. */
10933
11038
  steps: array(PipelineStepInputSchema).readonly().optional(),
10934
11039
  /** Audio classification branch. `enabled:false` disables, null skips. */
10935
11040
  audio: object({
10936
- engine: PipelineEngineChoiceSchema,
10937
- modelId: string(),
11041
+ modelId: string().optional(),
10938
11042
  enabled: boolean()
10939
11043
  }).nullable().optional(),
10940
11044
  /**
@@ -12364,7 +12468,9 @@ var AddonPageDeclarationSchema$1 = object({
12364
12468
  icon: string(),
12365
12469
  path: string(),
12366
12470
  remoteName: string(),
12367
- bundle: string()
12471
+ bundle: string(),
12472
+ section: string().optional(),
12473
+ sectionLabel: string().optional()
12368
12474
  });
12369
12475
  var AddonPageInfoSchema = object({
12370
12476
  addonId: string(),
@@ -12404,7 +12510,18 @@ var AddonPageDeclarationSchema = object({
12404
12510
  * the static-file route can compute an mtime-based cache-buster URL
12405
12511
  * without a separate filesystem stat.
12406
12512
  */
12407
- bundle: string()
12513
+ bundle: string(),
12514
+ /**
12515
+ * Sidebar section this page docks into. Well-known ids: `'detection'`,
12516
+ * `'cluster'`, `'administration'` — the page renders inside that group.
12517
+ * Any OTHER string creates (or joins) a custom section rendered after
12518
+ * the built-in groups; its label comes from `sectionLabel` (first
12519
+ * declaration wins), falling back to the id. Absent → the legacy
12520
+ * "Addon Pages" group.
12521
+ */
12522
+ section: string().optional(),
12523
+ /** Display label for a CUSTOM `section` id (ignored for well-known ids). */
12524
+ sectionLabel: string().optional()
12408
12525
  });
12409
12526
  method(_void(), array(AddonPageDeclarationSchema).readonly());
12410
12527
  var AddonHttpRouteSchema = object({
@@ -12620,6 +12737,17 @@ var WidgetMetadataSchema = object({
12620
12737
  deviceContext: boolean().default(false),
12621
12738
  integrationContext: boolean().default(false)
12622
12739
  }),
12740
+ /**
12741
+ * Loadable BEFORE authentication. The normal widget registry listing
12742
+ * (`addon-widgets.listWidgets`) is auth-gated, so a pre-auth surface
12743
+ * (the login page) cannot discover a widget through it. A widget that
12744
+ * declares `preAuth: true` marks itself as safe to mount on a pre-auth
12745
+ * screen — it is surfaced through the PUBLIC `auth.listLoginMethods`
12746
+ * login-method contribution channel (see `login-method.cap.ts`) rather
12747
+ * than the authenticated registry, and its bundle is served by the
12748
+ * public `/api/addon-widgets/:addonId/*` static route. Defaults false.
12749
+ */
12750
+ preAuth: boolean().optional().default(false),
12623
12751
  /** Dashboard placement HINTS (operator can override per instance). */
12624
12752
  defaultSize: WidgetSizeEnum.default("md"),
12625
12753
  allowedSizes: array(WidgetSizeEnum).readonly().default([
@@ -12927,6 +13055,66 @@ method(object({
12927
13055
  password: string()
12928
13056
  }), AuthResultSchema.nullable(), { kind: "mutation" }), method(object({ state: string() }), string()), method(record(string(), string()), AuthResultSchema, { kind: "mutation" }), method(object({ token: string() }), AuthResultSchema.nullable());
12929
13057
  /**
13058
+ * `login-method` — collection cap through which auth addons contribute
13059
+ * their pre-auth login surfaces to the login page. This is the SINGLE,
13060
+ * generic mechanism that supersedes the dead `auth.listProviders` reader:
13061
+ * every auth addon (OIDC, magic-link, WebAuthn/passkey) registers a
13062
+ * `login-method` provider and the PUBLIC `auth.listLoginMethods`
13063
+ * procedure aggregates them for the unauthenticated login page.
13064
+ *
13065
+ * A contribution is a discriminated union on `kind`:
13066
+ *
13067
+ * - `redirect` — a declarative button. The login page renders a generic
13068
+ * button that navigates to `startUrl` (an addon-owned HTTP route).
13069
+ * Covers OIDC (`/addon/auth-oidc/<id>/start`) and magic-link with
13070
+ * ZERO shell-side JS. A future SSO addon plugs in the same way — the
13071
+ * login page needs NO change.
13072
+ *
13073
+ * - `widget` — a Module-Federation widget the login page mounts (via
13074
+ * `loadRemoteBundle`) for an in-page ceremony. Covers the passkey
13075
+ * login ceremony, which must run `@simplewebauthn/browser` INSIDE the
13076
+ * addon bundle. The referenced widget also declares `preAuth: true` in
13077
+ * its `addon-widgets-source` catalog entry. `auth.listLoginMethods`
13078
+ * stamps a public `bundleUrl` from `addonId` + `bundle`.
13079
+ *
13080
+ * Every contribution carries a `stage`:
13081
+ * - `primary` — shown on the first credentials screen (OIDC /
13082
+ * magic-link buttons; a future usernameless passkey).
13083
+ * - `second-factor` — shown AFTER the password leg, gated on the
13084
+ * returned `factors` (passkey-as-2FA today).
13085
+ *
13086
+ * `mount: skip` — the cap is read server-side by the core auth router
13087
+ * (`registry.getCollection('login-method')`), never mounted as its own
13088
+ * tRPC router.
13089
+ */
13090
+ /** When a login method renders in the two-phase login flow. */
13091
+ var LoginStageEnum = _enum(["primary", "second-factor"]);
13092
+ /** One login-method contribution — redirect button OR pre-auth widget. */
13093
+ var LoginMethodContributionSchema = discriminatedUnion("kind", [object({
13094
+ kind: literal("redirect"),
13095
+ /** Stable id within the login-method set (e.g. `auth-oidc/google`). */
13096
+ id: string(),
13097
+ /** Operator-facing button label. */
13098
+ label: string(),
13099
+ /** lucide-react icon name. */
13100
+ icon: string().optional(),
13101
+ /** Addon-owned HTTP route the button navigates to (GET). */
13102
+ startUrl: string(),
13103
+ stage: LoginStageEnum
13104
+ }), object({
13105
+ kind: literal("widget"),
13106
+ /** Stable id within the login-method set (e.g. `auth-webauthn/passkey-login`). */
13107
+ id: string(),
13108
+ /** Owning addon id — drives the public bundle URL + the MF namespace. */
13109
+ addonId: string(),
13110
+ /** Bundle filename inside the addon's dist dir (`remoteEntry.js`). */
13111
+ bundle: string(),
13112
+ /** MF remote descriptor — `{ remoteName, exposedModule, componentKey }`. */
13113
+ remote: WidgetRemoteSchema,
13114
+ stage: LoginStageEnum
13115
+ })]);
13116
+ method(_void(), array(LoginMethodContributionSchema).readonly());
13117
+ /**
12930
13118
  * Orchestrator-side destination metadata. The orchestrator computes
12931
13119
  * `id = <addonId>:<subId>` from its provider lookup so consumers
12932
13120
  * (admin UI, restore flow) see one canonical key.
@@ -15283,11 +15471,11 @@ var pipelineAnalyticsCapability = {
15283
15471
  }
15284
15472
  };
15285
15473
  var CameraPipelineConfigSchema = object({
15286
- engine: PipelineEngineChoiceSchema,
15474
+ engine: PipelineEngineChoiceSchema.optional(),
15287
15475
  steps: array(PipelineStepInputSchema).readonly(),
15288
15476
  audio: object({
15289
- engine: PipelineEngineChoiceSchema,
15290
- modelId: string(),
15477
+ engine: PipelineEngineChoiceSchema.optional(),
15478
+ modelId: string().optional(),
15291
15479
  enabled: boolean(),
15292
15480
  settings: record(string(), unknown()).readonly().optional()
15293
15481
  }).nullable().optional()
@@ -15302,7 +15490,7 @@ var PipelineTemplateSchema = object({
15302
15490
  });
15303
15491
  var AgentAddonConfigSchema = object({
15304
15492
  enabled: boolean(),
15305
- modelId: string(),
15493
+ modelId: string().optional(),
15306
15494
  settings: record(string(), unknown()).readonly()
15307
15495
  });
15308
15496
  var AgentPipelineSettingsSchema = object({
@@ -15312,12 +15500,25 @@ var AgentPipelineSettingsSchema = object({
15312
15500
  detectWeight: number().positive().optional(),
15313
15501
  /** Node is eligible to run the detection pipeline (decode + inference). */
15314
15502
  detect: boolean().optional(),
15315
- /** Node is eligible to host decoder sessions. */
15503
+ /**
15504
+ * DEPRECATED AND IGNORED. Decode is always co-located with its frame
15505
+ * consumer, so decode eligibility IS detect eligibility. Kept optional in
15506
+ * the schema ONLY so persisted stores written before the removal still
15507
+ * parse — no code reads it and no write path emits it.
15508
+ */
15316
15509
  decode: boolean().optional(),
15317
15510
  /** Node is eligible to run audio-analyzer sessions. */
15318
15511
  audio: boolean().optional(),
15319
15512
  /** Node is eligible to be the ingest / source-owner (serve the restream). */
15320
- ingest: boolean().optional()
15513
+ ingest: boolean().optional(),
15514
+ /**
15515
+ * Operator override for the LAN host a cross-node decoder dials to reach
15516
+ * THIS node's restream (Cluster UI). Absent → auto-detect: a remote runner
15517
+ * falls back to its `CAMSTACK_HUB_URL`-derived host (the Moleculer address
15518
+ * it already uses to reach the hub). Set this only when the auto-detected
15519
+ * address is wrong (multi-homed host, NAT, custom interface).
15520
+ */
15521
+ reachableHost: string().optional()
15321
15522
  });
15322
15523
  var CameraPipelineForAgentSchema = object({
15323
15524
  steps: array(PipelineStepInputSchema).readonly(),
@@ -15365,25 +15566,6 @@ var PipelineAssignmentSchema = object({
15365
15566
  assignedAt: number()
15366
15567
  });
15367
15568
  /**
15368
- * Decoder placement record. Symmetric to `PipelineAssignmentSchema` but for
15369
- * the decoder-node placement domain (`balanceDecoder` decision: manual pin
15370
- * → co-located with pipeline → capacity).
15371
- */
15372
- var DecoderAssignmentSchema = object({
15373
- deviceId: number(),
15374
- /** Moleculer node id of the decoder provider currently responsible for this camera. */
15375
- decoderNodeId: string(),
15376
- /** True when the assignment was set manually via `assignDecoder`, false when chosen by the balancer. */
15377
- pinned: boolean(),
15378
- /** Why this assignment was made — useful for debugging the decoder balancer. */
15379
- reason: _enum([
15380
- "manual",
15381
- "co-located",
15382
- "capacity",
15383
- "hardware-affinity"
15384
- ])
15385
- });
15386
- /**
15387
15569
  * Per-agent load summary surfaced to the load balancer + dashboards.
15388
15570
  * Aggregated from each runner's `getLocalLoad` cap call.
15389
15571
  */
@@ -15423,6 +15605,15 @@ var GlobalMetricsSchema = object({
15423
15605
  * capability providers.
15424
15606
  */
15425
15607
  var CapabilityBindingsSchema = record(string(), string());
15608
+ /**
15609
+ * The cluster's single camera-source owner (`clusterRoles.ingestNode`) plus
15610
+ * its LAN-reachable host, if one is registered. See `getIngestOwner`.
15611
+ */
15612
+ var IngestOwnerSchema = object({
15613
+ ownerNodeId: string(),
15614
+ reachableHost: string().optional(),
15615
+ configIssue: string().optional()
15616
+ });
15426
15617
  /** Source block — always present; derives from the stream catalog. */
15427
15618
  var CameraSourceStatusSchema = object({ streams: array(object({
15428
15619
  camStreamId: string(),
@@ -15437,6 +15628,14 @@ var CameraAssignmentStatusSchema = object({
15437
15628
  detectionNodeId: string().nullable(),
15438
15629
  decoderNodeId: string().nullable(),
15439
15630
  audioNodeId: string().nullable(),
15631
+ /**
15632
+ * The node that OWNS this camera's physical source pull (dials the RTSP and
15633
+ * hosts the broker/restream) — the cluster ingest owner today
15634
+ * (`clusterRoles.ingestNode`), per-camera once source assignment lands. Lets
15635
+ * the UI show WHERE a camera is sourced without SSH/logs, and is the node the
15636
+ * broker block below was read from (pinned). Nullable only pre-wiring.
15637
+ */
15638
+ sourceNodeId: string().nullable(),
15440
15639
  pinned: object({
15441
15640
  detection: boolean(),
15442
15641
  decoder: boolean(),
@@ -15569,16 +15768,7 @@ method(object({
15569
15768
  }), object({ success: literal(true) }), {
15570
15769
  kind: "mutation",
15571
15770
  auth: "admin"
15572
- }), method(object({
15573
- deviceId: number(),
15574
- nodeId: string()
15575
- }), _void(), {
15576
- kind: "mutation",
15577
- auth: "admin"
15578
- }), method(object({ deviceId: number() }), _void(), {
15579
- kind: "mutation",
15580
- auth: "admin"
15581
- }), method(_void(), array(DecoderAssignmentSchema).readonly()), method(object({
15771
+ }), method(_void(), IngestOwnerSchema), method(object({
15582
15772
  deviceId: number(),
15583
15773
  nodeId: string()
15584
15774
  }), object({ success: literal(true) }), {
@@ -15599,10 +15789,7 @@ method(object({
15599
15789
  nodeId: string(),
15600
15790
  pinned: boolean(),
15601
15791
  assignedAt: number()
15602
- }))), method(object({
15603
- deviceId: number(),
15604
- pipelineNodeId: string().optional()
15605
- }), DecoderAssignmentSchema), method(object({ agentNodeId: string() }), AgentPipelineSettingsSchema.nullable()), method(_void(), array(object({
15792
+ }))), method(object({ agentNodeId: string() }), AgentPipelineSettingsSchema.nullable()), method(_void(), array(object({
15606
15793
  nodeId: string(),
15607
15794
  settings: AgentPipelineSettingsSchema
15608
15795
  })).readonly()), method(object({
@@ -15632,12 +15819,26 @@ method(object({
15632
15819
  }), method(object({
15633
15820
  agentNodeId: string(),
15634
15821
  detect: boolean().nullable().optional(),
15635
- decode: boolean().nullable().optional(),
15636
15822
  audio: boolean().nullable().optional(),
15637
15823
  ingest: boolean().nullable().optional()
15638
15824
  }), object({ success: literal(true) }), {
15639
15825
  kind: "mutation",
15640
15826
  auth: "admin"
15827
+ }), method(object({
15828
+ agentNodeId: string(),
15829
+ reachableHost: string().nullable()
15830
+ }), object({ success: literal(true) }), {
15831
+ kind: "mutation",
15832
+ auth: "admin"
15833
+ }), method(object({ agentNodeId: string() }), object({
15834
+ success: literal(true),
15835
+ /** Hardware-aware default detection model now in effect on the node (null when unresolvable). */
15836
+ effectiveModelId: string().nullable(),
15837
+ /** Number of cameras whose node-scoped overrides were cleared. */
15838
+ clearedCameraOverrides: number()
15839
+ }), {
15840
+ kind: "mutation",
15841
+ auth: "admin"
15641
15842
  }), method(object({ deviceId: number() }), CameraPipelineSettingsSchema.nullable()), method(object({
15642
15843
  deviceId: number(),
15643
15844
  addonId: string(),
@@ -15682,22 +15883,131 @@ method(object({
15682
15883
  kind: "mutation",
15683
15884
  auth: "admin"
15684
15885
  });
15685
- var RegisteredStreamSchema = object({
15686
- streamId: string(),
15687
- label: string().optional(),
15688
- codec: string(),
15689
- type: _enum(["video", "audio"]),
15690
- sourceUrl: string()
15886
+ /**
15887
+ * server-management — per-NODE singleton capability for a node's ROOT
15888
+ * package lifecycle (runtime-updatable node packages, phase 2: hub + docker
15889
+ * agents).
15890
+ *
15891
+ * Each node's root package (`@camstack/server` on the hub, `@camstack/agent`
15892
+ * on agents) carries the whole software stack in its npm dep tree, so ONE
15893
+ * version describes the node. Updates install into
15894
+ * `<dataDir>/server-root/versions/<v>/` and apply on restart via the baked
15895
+ * starter (probation boot + auto-rollback to N-1).
15896
+ *
15897
+ * Providers:
15898
+ * - HUB: `ServerUpdateService` behind the `server-provided` mount
15899
+ * (`buildServerProviders` in trpc.router.ts) — the default target for
15900
+ * unpinned calls.
15901
+ * - AGENT: `AgentUpdateService` registered by the agent bootstrap under
15902
+ * the synthetic `agent-runtime` addonId and declared in the agent's
15903
+ * `$hub.registerNode` manifest.
15904
+ *
15905
+ * Node routing: singleton caps get the codegen/runtime-builder `nodeId`
15906
+ * injection on every method — `input.nodeId` (or `nodePin(nodeId)` from the
15907
+ * SDK) routes the call to that node's provider via the standard remote
15908
+ * proxy (`createCapabilityProxy` → `$agent-cap-fwd` → the agent's
15909
+ * in-process provider lookup). No `nodeId` → the hub's own provider.
15910
+ *
15911
+ * Spec: docs/superpowers/specs/2026-07-12-runtime-updatable-node-packages-design.md
15912
+ */
15913
+ /**
15914
+ * Where the running hub's code was loaded from:
15915
+ * - `workspace` — dev checkout (tsx / workspace dist); the starter defers to
15916
+ * plain resolution and runtime updates are refused.
15917
+ * - `baked` — the immutable image seed closure (no data-dir root active).
15918
+ * - `data-root` — the runtime-updatable `<dataDir>/server-root` closure.
15919
+ */
15920
+ var ServerBootModeSchema = _enum([
15921
+ "workspace",
15922
+ "baked",
15923
+ "data-root"
15924
+ ]);
15925
+ /**
15926
+ * Update lifecycle state:
15927
+ * - `idle` / `checking` / `staging` — steady / in-flight registry work.
15928
+ * - `pending-restart` — a version is staged and the node has NOT yet
15929
+ * restarted onto it (still running the OLD version).
15930
+ * - `awaiting-confirmation` — the node HAS restarted onto the staged version
15931
+ * (it is the active probation boot) and is waiting to confirm boot-health.
15932
+ * Apply/rollback are refused in this state and the node must NOT be
15933
+ * manually restarted, or the probation boot auto-rolls-back.
15934
+ */
15935
+ var ServerUpdateStateSchema = _enum([
15936
+ "idle",
15937
+ "checking",
15938
+ "staging",
15939
+ "pending-restart",
15940
+ "awaiting-confirmation"
15941
+ ]);
15942
+ var ServerRollbackInfoSchema = object({
15943
+ /** The version that failed (or was manually rolled back). */
15944
+ fromVersion: string(),
15945
+ /** The version rolled back to; null = the baked seed. */
15946
+ toVersion: string().nullable(),
15947
+ atMs: number(),
15948
+ reason: string()
15691
15949
  });
15692
- var ExposedResourceSchema = object({
15693
- streamId: string(),
15694
- format: string(),
15695
- value: string()
15950
+ var ServerPackageStatusSchema = object({
15951
+ /** Root package name (`@camstack/server` on the hub). */
15952
+ packageName: string(),
15953
+ /** Version of the code the running process ACTUALLY loaded. */
15954
+ runningVersion: string().nullable(),
15955
+ /** Node.js runtime version the node's process runs on (`process.versions.node`). */
15956
+ nodeRuntimeVersion: string().nullable(),
15957
+ /** Active data-dir root version; null when booted from seed/workspace. */
15958
+ activeVersion: string().nullable(),
15959
+ /** N-1 version kept for rollback; null when no previous version exists. */
15960
+ previousVersion: string().nullable(),
15961
+ /** Version of the immutable baked seed closure (image fallback). */
15962
+ seedVersion: string().nullable(),
15963
+ /** Latest registry version from the most recent check (null = never checked). */
15964
+ latestVersion: string().nullable(),
15965
+ updateAvailable: boolean(),
15966
+ bootMode: ServerBootModeSchema,
15967
+ updateState: ServerUpdateStateSchema,
15968
+ /** Version staged + awaiting its probation boot, when one is pending. */
15969
+ pendingVersion: string().nullable(),
15970
+ /** Set when the last freshly-activated version failed its boot health-check. */
15971
+ rolledBack: ServerRollbackInfoSchema.nullable(),
15972
+ /**
15973
+ * True when `server-root/state.json` EXISTS but is unreadable/corrupt — the
15974
+ * hub is running from the baked seed (or workspace) while installed data-dir
15975
+ * versions are being IGNORED. Surfaced as a warning in the UI.
15976
+ */
15977
+ stateFileCorrupt: boolean(),
15978
+ lastCheckedAtMs: number().nullable()
15979
+ });
15980
+ var ServerUpdateCheckResultSchema = object({
15981
+ packageName: string(),
15982
+ runningVersion: string().nullable(),
15983
+ latestVersion: string().nullable(),
15984
+ updateAvailable: boolean(),
15985
+ checkedAtMs: number(),
15986
+ /** Non-null when the registry lookup failed (offline, bad registry, …). */
15987
+ error: string().nullable()
15988
+ });
15989
+ var ServerUpdateActionResultSchema = object({
15990
+ accepted: boolean(),
15991
+ targetVersion: string().nullable(),
15992
+ /** True when a graceful restart was scheduled to apply the change. */
15993
+ restarting: boolean(),
15994
+ message: string()
15995
+ });
15996
+ method(_void(), ServerPackageStatusSchema, { auth: "admin" }), method(_void(), ServerUpdateCheckResultSchema, {
15997
+ kind: "mutation",
15998
+ auth: "admin"
15999
+ }), method(object({
16000
+ /** Explicit target version; omitted = latest from the registry. */
16001
+ version: string().optional() }), ServerUpdateActionResultSchema, {
16002
+ kind: "mutation",
16003
+ auth: "admin"
16004
+ }), method(_void(), ServerUpdateActionResultSchema, {
16005
+ kind: "mutation",
16006
+ auth: "admin"
16007
+ }), method(_void(), ServerUpdateActionResultSchema, {
16008
+ kind: "mutation",
16009
+ auth: "admin"
15696
16010
  });
15697
- method(object({
15698
- deviceId: number(),
15699
- streams: array(RegisteredStreamSchema).readonly()
15700
- }), _void(), { kind: "mutation" }), method(object({ deviceId: number() }), _void(), { kind: "mutation" }), method(object({ deviceId: number() }), array(ExposedResourceSchema).readonly());
15701
16011
  /**
15702
16012
  * Query filter for settings-store collections.
15703
16013
  */
@@ -15850,9 +16160,9 @@ method(SendEmailInputSchema, SendEmailResultSchema, {
15850
16160
  /**
15851
16161
  * A single device snapshot returned as base64 JPEG/PNG.
15852
16162
  *
15853
- * Shared with the `snapshot-provider` collection cap the orchestrator
15854
- * receives the same shape from each native provider and from the
15855
- * broker-based fallback.
16163
+ * The `SnapshotAddon` wrapper returns this shape whether the frame came from
16164
+ * the device-native provider (onboard capture) or from the stream-broker
16165
+ * prebuffer fallback.
15856
16166
  */
15857
16167
  var SnapshotImageSchema = object({
15858
16168
  base64: string(),
@@ -15883,11 +16193,12 @@ DeviceType.Camera, method(object({
15883
16193
  }), SnapshotImageSchema.nullable()), method(object({ deviceId: number() }), _void(), {
15884
16194
  kind: "mutation",
15885
16195
  auth: "admin"
15886
- });
15887
- method(object({ deviceId: number() }), boolean()), method(object({
16196
+ }), systemMethod(object({ deviceIds: array(number()).min(1).max(200) }), array(object({
15888
16197
  deviceId: number(),
15889
- streamId: string().optional()
15890
- }), SnapshotImageSchema.nullable());
16198
+ lastCapturedAt: number().nullable(),
16199
+ cacheAgeMs: number().nullable(),
16200
+ etag: string().nullable()
16201
+ })));
15891
16202
  /**
15892
16203
  * `sso-bridge` — internal hub-only cap that lets SSO-style auth
15893
16204
  * providers (OIDC, SAML, magic-link, …) mint an HMAC-signed token
@@ -16138,10 +16449,32 @@ method(_void(), array(TurnServerSchema).readonly());
16138
16449
  * b. `finishAuthentication({userId, response})` → server verifies
16139
16450
  * the assertion, bumps the credential counter, returns ok.
16140
16451
  *
16452
+ * 2b. Usernameless (discoverable-credential) authentication — the
16453
+ * passkey IS the primary factor, no password leg:
16454
+ * a. `beginDiscoverableAuthentication({})` → assertion options with
16455
+ * EMPTY `allowCredentials` (the browser offers every resident
16456
+ * passkey it holds for this RP) + `userVerification: 'required'`
16457
+ * (the passkey replaces both factors, so UV is mandatory).
16458
+ * The challenge is stored server-side, NOT bound to any user.
16459
+ * b. `finishDiscoverableAuthentication({response})` → the provider
16460
+ * resolves the credential by the response's credential id,
16461
+ * verifies the assertion against the stored challenge + that
16462
+ * credential's public key/counter, and returns the OWNING
16463
+ * `userId` — the caller (core auth router) mints the session.
16464
+ *
16141
16465
  * 3. Management:
16142
16466
  * - `listPasskeys({userId})` — enumerate user's enrolled credentials.
16143
16467
  * - `removePasskey({userId, credentialId})` — revoke one credential.
16144
16468
  *
16469
+ * 4. Second-factor preference (opt-in, default OFF):
16470
+ * Enrolling a passkey only enables passkey-FIRST sign-in. It is
16471
+ * demanded as a second factor after a password login ONLY when the
16472
+ * user explicitly opts in via `setSecondFactorPreference`.
16473
+ * - `getSecondFactorPreference({userId})` → `{ enabled }` (missing
16474
+ * row ⇒ `enabled: false`).
16475
+ * - `setSecondFactorPreference({userId, enabled})` — persisted by
16476
+ * the providing addon beside its credentials.
16477
+ *
16145
16478
  * Challenges are short-lived (5 min, in-memory). The cap is internal —
16146
16479
  * the admin-ui composes the begin/finish round-trip and never exposes
16147
16480
  * the cap to non-admins.
@@ -16184,6 +16517,17 @@ method(object({
16184
16517
  }), object({ verified: boolean() }), {
16185
16518
  kind: "mutation",
16186
16519
  access: "view"
16520
+ }), method(object({}), object({ optionsJSON: record(string(), unknown()) }), {
16521
+ kind: "mutation",
16522
+ access: "view"
16523
+ }), method(object({
16524
+ /** AuthenticationResponseJSON from the browser. */
16525
+ response: record(string(), unknown()) }), object({
16526
+ verified: boolean(),
16527
+ userId: string().nullable()
16528
+ }), {
16529
+ kind: "mutation",
16530
+ access: "view"
16187
16531
  }), method(object({ userId: string() }), array(PasskeySummarySchema), { auth: "admin" }), method(object({
16188
16532
  userId: string(),
16189
16533
  credentialId: string()
@@ -16191,6 +16535,13 @@ method(object({
16191
16535
  kind: "mutation",
16192
16536
  auth: "admin",
16193
16537
  access: "delete"
16538
+ }), method(object({ userId: string() }), object({ enabled: boolean() }), { auth: "admin" }), method(object({
16539
+ userId: string(),
16540
+ enabled: boolean()
16541
+ }), object({ success: literal(true) }), {
16542
+ kind: "mutation",
16543
+ auth: "admin",
16544
+ access: "create"
16194
16545
  });
16195
16546
  /**
16196
16547
  * `videoclips` — the unified, navigable-clip surface for a camera.
@@ -16258,9 +16609,10 @@ var videoclipsCapability = {
16258
16609
  }
16259
16610
  };
16260
16611
  /**
16261
- * Optional client-side hints sent at session creation to help the
16262
- * provider pick the best native source. All fields are optional —
16263
- * a viewer that knows nothing still gets a sane default.
16612
+ * Optional client-side hints sent at session creation to help the provider
16613
+ * pick the best native source. All fields optional — a viewer that knows
16614
+ * nothing still gets a sane default. (Relocated from the retired `webrtc`
16615
+ * collection cap; this `webrtc-session` cap is the live signaling surface.)
16264
16616
  */
16265
16617
  var webrtcClientHintsSchema = object({
16266
16618
  viewportWidth: number().int().positive().optional(),
@@ -16271,22 +16623,6 @@ var webrtcClientHintsSchema = object({
16271
16623
  /** Hard tier override; takes precedence over scoring when registered. */
16272
16624
  prefersTier: string().optional()
16273
16625
  }).partial();
16274
- method(object({
16275
- streamId: string(),
16276
- sdpOffer: string()
16277
- }), string(), { kind: "mutation" }), method(object({ streamId: string() }), boolean()), method(object({
16278
- streamId: string(),
16279
- codec: string()
16280
- }), _void(), { kind: "mutation" }), method(object({ streamId: string() }), _void(), { kind: "mutation" }), method(object({
16281
- streamId: string(),
16282
- hints: webrtcClientHintsSchema.optional()
16283
- }), object({
16284
- sessionId: string(),
16285
- sdpOffer: string()
16286
- }), { kind: "mutation" }), method(object({
16287
- sessionId: string(),
16288
- sdpAnswer: string()
16289
- }), _void(), { kind: "mutation" }), method(object({ sessionId: string() }), _void(), { kind: "mutation" }), method(object({ streamId: string() }), boolean());
16290
16626
  /**
16291
16627
  * Discriminated target for a WebRTC session. The client sends this
16292
16628
  * structured object instead of building / parsing brokerId strings;
@@ -17740,6 +18076,16 @@ var TopologyCategorySchema = object({
17740
18076
  healthy: number(),
17741
18077
  addons: array(TopologyCategoryAddonSchema).readonly()
17742
18078
  });
18079
+ /**
18080
+ * The node's runtime-updatable ROOT package (`@camstack/server` on the hub,
18081
+ * `@camstack/agent` on agents) as reported by its `registerNode` manifest —
18082
+ * version visibility for the Server management surface. Nullable: offline
18083
+ * rows and pre-phase-2 nodes report none.
18084
+ */
18085
+ var TopologyRootPackageSchema = object({
18086
+ name: string(),
18087
+ version: string()
18088
+ });
17743
18089
  var TopologyNodeSchema = object({
17744
18090
  id: string(),
17745
18091
  name: string(),
@@ -17763,7 +18109,8 @@ var TopologyNodeSchema = object({
17763
18109
  status: string()
17764
18110
  })).readonly(),
17765
18111
  processes: array(TopologyProcessSchema).readonly(),
17766
- categories: array(TopologyCategorySchema).readonly()
18112
+ categories: array(TopologyCategorySchema).readonly(),
18113
+ rootPackage: TopologyRootPackageSchema.nullable()
17767
18114
  });
17768
18115
  var CapUsageEdgeSchema = object({
17769
18116
  callerAddonId: string(),
@@ -20587,6 +20934,12 @@ Object.freeze({
20587
20934
  addonId: null,
20588
20935
  access: "create"
20589
20936
  },
20937
+ "loginMethod.getLoginMethods": {
20938
+ capName: "login-method",
20939
+ capScope: "system",
20940
+ addonId: null,
20941
+ access: "view"
20942
+ },
20590
20943
  "mediaPlayer.next": {
20591
20944
  capName: "media-player",
20592
20945
  capScope: "device",
@@ -21217,23 +21570,23 @@ Object.freeze({
21217
21570
  addonId: null,
21218
21571
  access: "create"
21219
21572
  },
21220
- "pipelineExecutor.deleteModel": {
21573
+ "pipelineExecutor.clearDeviceOverrides": {
21221
21574
  capName: "pipeline-executor",
21222
21575
  capScope: "system",
21223
21576
  addonId: null,
21224
21577
  access: "delete"
21225
21578
  },
21226
- "pipelineExecutor.deleteTemplate": {
21579
+ "pipelineExecutor.deleteModel": {
21227
21580
  capName: "pipeline-executor",
21228
21581
  capScope: "system",
21229
21582
  addonId: null,
21230
21583
  access: "delete"
21231
21584
  },
21232
- "pipelineExecutor.detect": {
21585
+ "pipelineExecutor.deleteTemplate": {
21233
21586
  capName: "pipeline-executor",
21234
21587
  capScope: "system",
21235
21588
  addonId: null,
21236
- access: "view"
21589
+ access: "delete"
21237
21590
  },
21238
21591
  "pipelineExecutor.downloadModel": {
21239
21592
  capName: "pipeline-executor",
@@ -21427,13 +21780,13 @@ Object.freeze({
21427
21780
  addonId: null,
21428
21781
  access: "create"
21429
21782
  },
21430
- "pipelineOrchestrator.assignAudio": {
21431
- capName: "pipeline-orchestrator",
21783
+ "pipelineExecutor.validatePipeline": {
21784
+ capName: "pipeline-executor",
21432
21785
  capScope: "system",
21433
21786
  addonId: null,
21434
- access: "create"
21787
+ access: "view"
21435
21788
  },
21436
- "pipelineOrchestrator.assignDecoder": {
21789
+ "pipelineOrchestrator.assignAudio": {
21437
21790
  capName: "pipeline-orchestrator",
21438
21791
  capScope: "system",
21439
21792
  addonId: null,
@@ -21517,19 +21870,13 @@ Object.freeze({
21517
21870
  addonId: null,
21518
21871
  access: "view"
21519
21872
  },
21520
- "pipelineOrchestrator.getDecoderAssignment": {
21521
- capName: "pipeline-orchestrator",
21522
- capScope: "system",
21523
- addonId: null,
21524
- access: "view"
21525
- },
21526
- "pipelineOrchestrator.getDecoderAssignments": {
21873
+ "pipelineOrchestrator.getGlobalMetrics": {
21527
21874
  capName: "pipeline-orchestrator",
21528
21875
  capScope: "system",
21529
21876
  addonId: null,
21530
21877
  access: "view"
21531
21878
  },
21532
- "pipelineOrchestrator.getGlobalMetrics": {
21879
+ "pipelineOrchestrator.getIngestOwner": {
21533
21880
  capName: "pipeline-orchestrator",
21534
21881
  capScope: "system",
21535
21882
  addonId: null,
@@ -21571,6 +21918,12 @@ Object.freeze({
21571
21918
  addonId: null,
21572
21919
  access: "delete"
21573
21920
  },
21921
+ "pipelineOrchestrator.resetNodePipelineDefaults": {
21922
+ capName: "pipeline-orchestrator",
21923
+ capScope: "system",
21924
+ addonId: null,
21925
+ access: "delete"
21926
+ },
21574
21927
  "pipelineOrchestrator.resolvePipeline": {
21575
21928
  capName: "pipeline-orchestrator",
21576
21929
  capScope: "system",
@@ -21607,37 +21960,37 @@ Object.freeze({
21607
21960
  addonId: null,
21608
21961
  access: "create"
21609
21962
  },
21610
- "pipelineOrchestrator.setCameraPipelineForAgent": {
21963
+ "pipelineOrchestrator.setAgentReachableHost": {
21611
21964
  capName: "pipeline-orchestrator",
21612
21965
  capScope: "system",
21613
21966
  addonId: null,
21614
21967
  access: "create"
21615
21968
  },
21616
- "pipelineOrchestrator.setCameraStepOverride": {
21969
+ "pipelineOrchestrator.setCameraPipelineForAgent": {
21617
21970
  capName: "pipeline-orchestrator",
21618
21971
  capScope: "system",
21619
21972
  addonId: null,
21620
21973
  access: "create"
21621
21974
  },
21622
- "pipelineOrchestrator.setCameraStepToggle": {
21975
+ "pipelineOrchestrator.setCameraStepOverride": {
21623
21976
  capName: "pipeline-orchestrator",
21624
21977
  capScope: "system",
21625
21978
  addonId: null,
21626
21979
  access: "create"
21627
21980
  },
21628
- "pipelineOrchestrator.setCapabilityBinding": {
21981
+ "pipelineOrchestrator.setCameraStepToggle": {
21629
21982
  capName: "pipeline-orchestrator",
21630
21983
  capScope: "system",
21631
21984
  addonId: null,
21632
21985
  access: "create"
21633
21986
  },
21634
- "pipelineOrchestrator.unassignAudio": {
21987
+ "pipelineOrchestrator.setCapabilityBinding": {
21635
21988
  capName: "pipeline-orchestrator",
21636
21989
  capScope: "system",
21637
21990
  addonId: null,
21638
21991
  access: "create"
21639
21992
  },
21640
- "pipelineOrchestrator.unassignDecoder": {
21993
+ "pipelineOrchestrator.unassignAudio": {
21641
21994
  capName: "pipeline-orchestrator",
21642
21995
  capScope: "system",
21643
21996
  addonId: null,
@@ -21937,33 +22290,45 @@ Object.freeze({
21937
22290
  addonId: null,
21938
22291
  access: "create"
21939
22292
  },
21940
- "restreamer.getExposedResources": {
21941
- capName: "restreamer",
22293
+ "scriptRunner.run": {
22294
+ capName: "script-runner",
22295
+ capScope: "device",
22296
+ addonId: null,
22297
+ access: "create"
22298
+ },
22299
+ "scriptRunner.stop": {
22300
+ capName: "script-runner",
22301
+ capScope: "device",
22302
+ addonId: null,
22303
+ access: "create"
22304
+ },
22305
+ "serverManagement.applyServerUpdate": {
22306
+ capName: "server-management",
21942
22307
  capScope: "system",
21943
22308
  addonId: null,
21944
- access: "view"
22309
+ access: "create"
21945
22310
  },
21946
- "restreamer.registerDevice": {
21947
- capName: "restreamer",
22311
+ "serverManagement.checkServerUpdate": {
22312
+ capName: "server-management",
21948
22313
  capScope: "system",
21949
22314
  addonId: null,
21950
22315
  access: "create"
21951
22316
  },
21952
- "restreamer.unregisterDevice": {
21953
- capName: "restreamer",
22317
+ "serverManagement.getServerPackageStatus": {
22318
+ capName: "server-management",
21954
22319
  capScope: "system",
21955
22320
  addonId: null,
21956
- access: "delete"
22321
+ access: "view"
21957
22322
  },
21958
- "scriptRunner.run": {
21959
- capName: "script-runner",
21960
- capScope: "device",
22323
+ "serverManagement.restartServer": {
22324
+ capName: "server-management",
22325
+ capScope: "system",
21961
22326
  addonId: null,
21962
22327
  access: "create"
21963
22328
  },
21964
- "scriptRunner.stop": {
21965
- capName: "script-runner",
21966
- capScope: "device",
22329
+ "serverManagement.rollbackServerUpdate": {
22330
+ capName: "server-management",
22331
+ capScope: "system",
21967
22332
  addonId: null,
21968
22333
  access: "create"
21969
22334
  },
@@ -22051,23 +22416,17 @@ Object.freeze({
22051
22416
  addonId: null,
22052
22417
  access: "view"
22053
22418
  },
22054
- "snapshot.invalidateCache": {
22419
+ "snapshot.getSnapshotOverview": {
22055
22420
  capName: "snapshot",
22056
22421
  capScope: "device",
22057
22422
  addonId: null,
22058
- access: "create"
22059
- },
22060
- "snapshotProvider.getSnapshot": {
22061
- capName: "snapshot-provider",
22062
- capScope: "system",
22063
- addonId: null,
22064
22423
  access: "view"
22065
22424
  },
22066
- "snapshotProvider.supportsDevice": {
22067
- capName: "snapshot-provider",
22068
- capScope: "system",
22425
+ "snapshot.invalidateCache": {
22426
+ capName: "snapshot",
22427
+ capScope: "device",
22069
22428
  addonId: null,
22070
- access: "view"
22429
+ access: "create"
22071
22430
  },
22072
22431
  "ssoBridge.signBridgeToken": {
22073
22432
  capName: "sso-bridge",
@@ -22495,30 +22854,6 @@ Object.freeze({
22495
22854
  addonId: null,
22496
22855
  access: "view"
22497
22856
  },
22498
- "streamingEngine.getStreamUrl": {
22499
- capName: "streaming-engine",
22500
- capScope: "system",
22501
- addonId: null,
22502
- access: "view"
22503
- },
22504
- "streamingEngine.listStreams": {
22505
- capName: "streaming-engine",
22506
- capScope: "system",
22507
- addonId: null,
22508
- access: "view"
22509
- },
22510
- "streamingEngine.registerStream": {
22511
- capName: "streaming-engine",
22512
- capScope: "system",
22513
- addonId: null,
22514
- access: "create"
22515
- },
22516
- "streamingEngine.unregisterStream": {
22517
- capName: "streaming-engine",
22518
- capScope: "system",
22519
- addonId: null,
22520
- access: "delete"
22521
- },
22522
22857
  "streamParams.getConfigSchema": {
22523
22858
  capName: "stream-params",
22524
22859
  capScope: "device",
@@ -22765,6 +23100,12 @@ Object.freeze({
22765
23100
  addonId: null,
22766
23101
  access: "view"
22767
23102
  },
23103
+ "userPasskeys.beginDiscoverableAuthentication": {
23104
+ capName: "user-passkeys",
23105
+ capScope: "system",
23106
+ addonId: null,
23107
+ access: "view"
23108
+ },
22768
23109
  "userPasskeys.beginRegistration": {
22769
23110
  capName: "user-passkeys",
22770
23111
  capScope: "system",
@@ -22777,12 +23118,24 @@ Object.freeze({
22777
23118
  addonId: null,
22778
23119
  access: "view"
22779
23120
  },
23121
+ "userPasskeys.finishDiscoverableAuthentication": {
23122
+ capName: "user-passkeys",
23123
+ capScope: "system",
23124
+ addonId: null,
23125
+ access: "view"
23126
+ },
22780
23127
  "userPasskeys.finishRegistration": {
22781
23128
  capName: "user-passkeys",
22782
23129
  capScope: "system",
22783
23130
  addonId: null,
22784
23131
  access: "create"
22785
23132
  },
23133
+ "userPasskeys.getSecondFactorPreference": {
23134
+ capName: "user-passkeys",
23135
+ capScope: "system",
23136
+ addonId: null,
23137
+ access: "view"
23138
+ },
22786
23139
  "userPasskeys.listPasskeys": {
22787
23140
  capName: "user-passkeys",
22788
23141
  capScope: "system",
@@ -22795,6 +23148,12 @@ Object.freeze({
22795
23148
  addonId: null,
22796
23149
  access: "delete"
22797
23150
  },
23151
+ "userPasskeys.setSecondFactorPreference": {
23152
+ capName: "user-passkeys",
23153
+ capScope: "system",
23154
+ addonId: null,
23155
+ access: "create"
23156
+ },
22798
23157
  "vacuumControl.locate": {
22799
23158
  capName: "vacuum-control",
22800
23159
  capScope: "device",
@@ -22867,6 +23226,18 @@ Object.freeze({
22867
23226
  addonId: null,
22868
23227
  access: "view"
22869
23228
  },
23229
+ "viewerUi.getStaticDir": {
23230
+ capName: "viewer-ui",
23231
+ capScope: "system",
23232
+ addonId: null,
23233
+ access: "view"
23234
+ },
23235
+ "viewerUi.getVersion": {
23236
+ capName: "viewer-ui",
23237
+ capScope: "system",
23238
+ addonId: null,
23239
+ access: "view"
23240
+ },
22870
23241
  "waterHeater.setAway": {
22871
23242
  capName: "water-heater",
22872
23243
  capScope: "device",
@@ -22885,54 +23256,6 @@ Object.freeze({
22885
23256
  addonId: null,
22886
23257
  access: "create"
22887
23258
  },
22888
- "webrtc.closeSession": {
22889
- capName: "webrtc",
22890
- capScope: "system",
22891
- addonId: null,
22892
- access: "create"
22893
- },
22894
- "webrtc.createSession": {
22895
- capName: "webrtc",
22896
- capScope: "system",
22897
- addonId: null,
22898
- access: "create"
22899
- },
22900
- "webrtc.handleAnswer": {
22901
- capName: "webrtc",
22902
- capScope: "system",
22903
- addonId: null,
22904
- access: "create"
22905
- },
22906
- "webrtc.handleOffer": {
22907
- capName: "webrtc",
22908
- capScope: "system",
22909
- addonId: null,
22910
- access: "create"
22911
- },
22912
- "webrtc.hasAdaptiveBitrate": {
22913
- capName: "webrtc",
22914
- capScope: "system",
22915
- addonId: null,
22916
- access: "view"
22917
- },
22918
- "webrtc.registerStream": {
22919
- capName: "webrtc",
22920
- capScope: "system",
22921
- addonId: null,
22922
- access: "create"
22923
- },
22924
- "webrtc.supportsStream": {
22925
- capName: "webrtc",
22926
- capScope: "system",
22927
- addonId: null,
22928
- access: "view"
22929
- },
22930
- "webrtc.unregisterStream": {
22931
- capName: "webrtc",
22932
- capScope: "system",
22933
- addonId: null,
22934
- access: "delete"
22935
- },
22936
23259
  "webrtcSession.addIceCandidate": {
22937
23260
  capName: "webrtc-session",
22938
23261
  capScope: "device",