@camstack/addon-osd-manager 0.1.39 → 0.1.40

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.
Files changed (18) hide show
  1. package/dist/{MotionZonesSettings-CIXOIaxJ.mjs → MotionZonesSettings-BTOqeXRd.mjs} +2 -2
  2. package/dist/{PrivacyMaskSettings-BXVb51kq.mjs → PrivacyMaskSettings-BgmE0tQu.mjs} +4 -4
  3. package/dist/{SceneMonitorEditor-DYRLvvVA.mjs → SceneMonitorEditor-D4oig7v9.mjs} +3 -3
  4. package/dist/_stub.js +11 -11
  5. package/dist/{_virtual_mf-localSharedImportMap___mfe_internal__addon_osd_manager_page-BfqPLLgE.mjs → _virtual_mf-localSharedImportMap___mfe_internal__addon_osd_manager_page-C4iHNnmw.mjs} +4 -4
  6. package/dist/_virtual_mf___mfe_internal__addon_osd_manager_page__loadShare___mf_0_camstack_mf_1_types__loadShare__.js-Blhr4EyN.mjs +26 -0
  7. package/dist/{hostInit-C5XnMBDh.mjs → hostInit-DzLQY4CO.mjs} +3 -3
  8. package/dist/index.js +309 -207
  9. package/dist/index.mjs +309 -207
  10. package/dist/{player-overlays-BuhAo_Es.mjs → player-overlays-DaucHym7.mjs} +1 -1
  11. package/dist/remoteEntry.js +1 -1
  12. package/dist/{responsive-BAE2Alvc.mjs → responsive-DC2YNF2r.mjs} +1 -1
  13. package/dist/{square-7AGHps0Y.mjs → square-DuMw_5RG.mjs} +1 -1
  14. package/dist/{trash-2-CeWvoLug.mjs → trash-2-C54qifas.mjs} +1 -1
  15. package/dist/{use-device-snapshot-DW8FBhRd.mjs → use-device-snapshot-BVTu9rWV.mjs} +1 -1
  16. package/dist/{virtual_mf-REMOTE_ENTRY_ID___mfe_internal__addon_osd_manager_page__remoteEntry_js-hPck03Nc.mjs → virtual_mf-REMOTE_ENTRY_ID___mfe_internal__addon_osd_manager_page__remoteEntry_js-B-XuFKdU.mjs} +1 -1
  17. package/package.json +1 -1
  18. package/dist/_virtual_mf___mfe_internal__addon_osd_manager_page__loadShare___mf_0_camstack_mf_1_types__loadShare__.js-CnoMYUFR.mjs +0 -26
package/dist/index.mjs CHANGED
@@ -14724,6 +14724,133 @@ var embeddingEncoderCapability = {
14724
14724
  }
14725
14725
  };
14726
14726
  /**
14727
+ * `failure-contribution` — the capability an addon reports its OWN losses
14728
+ * through, per camera, with the denominator attached. It stores nothing.
14729
+ *
14730
+ * ## The twin of `load-contribution`, and why it is a twin and not a field
14731
+ *
14732
+ * `load-contribution` answers *what did this camera COST*. This answers *what
14733
+ * did this camera LOSE*. The reporting discipline is identical and deliberately
14734
+ * copied: the contributor reports what it already knows, hub-main adds only
14735
+ * `addonId`, nothing needs global knowledge, and there is no central list for
14736
+ * somebody to forget to edit.
14737
+ *
14738
+ * They are not merged, because their invariants are opposites:
14739
+ *
14740
+ * - a `load-contribution` measurement is **absent, never zero** — a zero would
14741
+ * claim a camera cost nothing, which is a measurement nobody made;
14742
+ * - a `failure-contribution` zero is the **most valuable value on the
14743
+ * surface** — `attempts: 400, succeeded: 400` is the proof a fix landed,
14744
+ * and it is exactly what an absent entry cannot say.
14745
+ *
14746
+ * Putting a loss counter on a cost entry would also break the reconciliation
14747
+ * that gives `load-contribution` its point: contributions are subtracted from
14748
+ * `metrics.node-processes-snapshot` to find processes nobody claims. A failure
14749
+ * has no process.
14750
+ *
14751
+ * ## Why not a log line, since the counters already exist
14752
+ *
14753
+ * Several of these paths already counted themselves — `CaptureScheduler`'s
14754
+ * per-device window, `KeyFrameCaptureLog`, `bumpCropMetric`. Every one of them
14755
+ * ends in a log line, and a log line is the thing the operator asked to stop
14756
+ * needing: *"possiamo armare questi errori intanto? Così al prossimo giro
14757
+ * ricontrolliamo tutti questi punti"*. Reading them meant grepping Loki and
14758
+ * hand-correlating timestamps, which is how a 22% thumbnail gap and a 3-hour
14759
+ * media blackout were both diagnosed. The counters stay; this is where they can
14760
+ * be READ.
14761
+ *
14762
+ * ## The rate is served with its denominator or not at all
14763
+ *
14764
+ * Every entry carries `attempts` and `succeeded`. A miss count alone is
14765
+ * unreadable: on 2026-08-28 the enrichment-crop miss count read as "35x worse
14766
+ * than yesterday" and was **flat across twelve hours** once divided by the
14767
+ * successes on the same path. A surface that publishes only the numerator
14768
+ * reproduces that mistake on every read.
14769
+ *
14770
+ * ## Shape
14771
+ *
14772
+ * Copied from `load-contribution.cap.ts` (`mode: 'collection'`,
14773
+ * `internal: true`, `mount: { kind: 'skip' }`): no tRPC route of its own and no
14774
+ * generated hooks, while `addons.listCapabilityProviders` still enumerates it
14775
+ * and the hub's `CapabilityRegistry` still holds an RPC proxy per provider — so
14776
+ * a forked runner's entries reach hub-main over transport that already exists.
14777
+ * No new UDS message, no second registry (D3). The operator reads the assembled
14778
+ * result through `system.getFailureContributions`.
14779
+ */
14780
+ var FailureReasonCountSchema = object({
14781
+ /**
14782
+ * Why the attempt did not land, in the contributor's own vocabulary —
14783
+ * `worker-lease-gone`, `queue-overflow`, `timeout`, `empty-read`. The same
14784
+ * strings that already appear in this repo's logs and, where one exists, the
14785
+ * same string the per-track `previewMissReason` records (D276): a second
14786
+ * vocabulary for the same loss would make the row and the counter
14787
+ * un-joinable.
14788
+ */
14789
+ reason: string(),
14790
+ count: number().int().nonnegative()
14791
+ });
14792
+ var FailureContributionSchema = object({
14793
+ /**
14794
+ * The failing path — `enrichment-crop`, `inference`, `plate-ocr`,
14795
+ * `person-over-vehicle`. Free text, for the reason `load-contribution` keeps
14796
+ * `unit` free: the families are owned by different addons and a shared enum
14797
+ * is a central list that rots invisibly.
14798
+ */
14799
+ family: string(),
14800
+ /**
14801
+ * The NUMERIC device id — the same value every log line carries as
14802
+ * `tags.deviceId`. Never nullable and never absent: a contributor that
14803
+ * cannot name the camera must not emit the entry, because a fleet total
14804
+ * cannot answer the only question anybody asks of this surface.
14805
+ */
14806
+ deviceId: number().int().positive(),
14807
+ /**
14808
+ * A second dimension inside the family: the model / step id for an inference
14809
+ * timeout, so "which camera AND which model" is one read. Absent when the
14810
+ * family has a single variant.
14811
+ */
14812
+ variant: string().optional(),
14813
+ /**
14814
+ * Epoch ms this counter started — the INCARNATION MARKER. A consumer
14815
+ * differencing two reads must drop the interval when it changes, because the
14816
+ * counter restarted from zero in a respawned runner. Same discipline as
14817
+ * `LoadContribution.startedAtMs`.
14818
+ */
14819
+ sinceMs: number(),
14820
+ /** Epoch ms it was read. `atMs - sinceMs` is the interval this covers. */
14821
+ atMs: number(),
14822
+ /**
14823
+ * THE DENOMINATOR — every attempt on this path for this camera in the
14824
+ * window. A failure count published without it is the mistake this schema
14825
+ * exists to make impossible.
14826
+ */
14827
+ attempts: number().int().nonnegative(),
14828
+ /** Attempts that landed. `attempts - succeeded` is the loss. */
14829
+ succeeded: number().int().nonnegative(),
14830
+ /** The loss, partitioned. Sums to `attempts - succeeded`. */
14831
+ reasons: array(FailureReasonCountSchema).readonly()
14832
+ });
14833
+ var failureContributionCapability = {
14834
+ name: "failure-contribution",
14835
+ scope: "system",
14836
+ mode: "collection",
14837
+ internal: true,
14838
+ methods: {
14839
+ /**
14840
+ * This addon's per-camera failure counters, read live from bounded in-RAM
14841
+ * state it already keeps. Inert: no persistence, no sampling, no timer.
14842
+ *
14843
+ * READING NEVER RESETS. The counters are CUMULATIVE since `sinceMs`, and a
14844
+ * consumer that wants a rate differences two reads. A draining read would
14845
+ * make two operators with the page open each destroy half of the other's
14846
+ * numbers, and `load-contribution` already settled the same question the
14847
+ * same way for `cpuSeconds`.
14848
+ */
14849
+ list: method(_void(), array(FailureContributionSchema).readonly()) },
14850
+ /** In-process only — enumerated through `addons.listCapabilityProviders`. */
14851
+ mount: { kind: "skip" }
14852
+ };
14853
+ /**
14727
14854
  * filesystem-browse — per-node capability for browsing the node's local
14728
14855
  * filesystem. Reads are unconfined (whole filesystem, from `/` down); WRITES
14729
14856
  * are sandboxed to operator-configured allowed roots (D115). Used by the
@@ -15334,6 +15461,82 @@ var llmCapability = {
15334
15461
  })
15335
15462
  }
15336
15463
  };
15464
+ var LoadContributionSchema = object({
15465
+ role: _enum([
15466
+ "decode",
15467
+ "transcode",
15468
+ "recording",
15469
+ "streaming",
15470
+ "detection"
15471
+ ]),
15472
+ /**
15473
+ * The NUMERIC device id — the same value every log line carries as
15474
+ * `tags.deviceId`. `null` means this cost genuinely belongs to no single
15475
+ * camera (a shared pool), NOT that the contributor forgot to look it up: a
15476
+ * contributor that cannot name its camera must not emit the entry at all,
15477
+ * because an unnamed per-camera entry is indistinguishable from a shared one
15478
+ * and would quietly turn one camera's cost into everybody's.
15479
+ */
15480
+ deviceId: number().int().positive().nullable(),
15481
+ attribution: _enum([
15482
+ "measured",
15483
+ "accounted",
15484
+ "unattributable"
15485
+ ]),
15486
+ /**
15487
+ * What ONE entry is, in the contributor's own words — `615/high`,
15488
+ * `617/native`, `cuda:0 shared pool`. Free text because the unit differs per
15489
+ * family and inventing a common one would lose the only information that
15490
+ * makes two entries for the same camera distinguishable.
15491
+ */
15492
+ unit: string(),
15493
+ /**
15494
+ * The OS process this cost lives in, when there is one. Present so a
15495
+ * consumer can (a) tell two generations of the same unit apart across a
15496
+ * restart, and (b) subtract claimed processes from the node's process
15497
+ * snapshot to see what NOBODY claimed. Absent for an entry that owns no
15498
+ * process of its own.
15499
+ */
15500
+ pid: number().int().positive().optional(),
15501
+ /**
15502
+ * When this generation started. The pid's incarnation marker: a consumer
15503
+ * differencing {@link LoadContributionSchema.shape.cpuSeconds} must drop the
15504
+ * window when this changes, because the counter restarted from zero in a new
15505
+ * process.
15506
+ */
15507
+ startedAtMs: number().optional(),
15508
+ /**
15509
+ * CUMULATIVE CPU seconds this unit has consumed since it started — user +
15510
+ * system, read from the child's own `/proc/<pid>/stat` at the moment the
15511
+ * contribution is asked for.
15512
+ *
15513
+ * Cumulative and not a rate on purpose: a rate needs a window, a window
15514
+ * needs a sampler, and a new per-node sampler is the defect half of
15515
+ * `docs/architecture/load-ledger.md` documents. A counter can be differenced
15516
+ * by whoever already keeps a history; a rate cannot be un-averaged.
15517
+ *
15518
+ * Absent — never zero — on a node with no `/proc`, on a read failure, and on
15519
+ * an entry with no process.
15520
+ */
15521
+ cpuSeconds: number().optional(),
15522
+ /** Resident bytes of this unit's process, same source and same rules. */
15523
+ rssBytes: number().optional()
15524
+ });
15525
+ var loadContributionCapability = {
15526
+ name: "load-contribution",
15527
+ scope: "system",
15528
+ mode: "collection",
15529
+ internal: true,
15530
+ methods: {
15531
+ /**
15532
+ * This addon's own cost entries, computed live from state it already
15533
+ * holds. Inert: no persistence, no sampling, no timer. It is answered on
15534
+ * whatever beat the caller already has.
15535
+ */
15536
+ list: method(_void(), array(LoadContributionSchema).readonly()) },
15537
+ /** In-process only — enumerated through `addons.listCapabilityProviders`. */
15538
+ mount: { kind: "skip" }
15539
+ };
15337
15540
  /**
15338
15541
  * `log-channels` — the capability an addon DECLARES its diagnostic channels
15339
15542
  * through. It stores nothing.
@@ -15442,209 +15645,6 @@ var logDestinationCapability = {
15442
15645
  mount: { kind: "skip" }
15443
15646
  };
15444
15647
  /**
15445
- * `failure-contribution` — the capability an addon reports its OWN losses
15446
- * through, per camera, with the denominator attached. It stores nothing.
15447
- *
15448
- * ## The twin of `load-contribution`, and why it is a twin and not a field
15449
- *
15450
- * `load-contribution` answers *what did this camera COST*. This answers *what
15451
- * did this camera LOSE*. The reporting discipline is identical and deliberately
15452
- * copied: the contributor reports what it already knows, hub-main adds only
15453
- * `addonId`, nothing needs global knowledge, and there is no central list for
15454
- * somebody to forget to edit.
15455
- *
15456
- * They are not merged, because their invariants are opposites:
15457
- *
15458
- * - a `load-contribution` measurement is **absent, never zero** — a zero would
15459
- * claim a camera cost nothing, which is a measurement nobody made;
15460
- * - a `failure-contribution` zero is the **most valuable value on the
15461
- * surface** — `attempts: 400, succeeded: 400` is the proof a fix landed,
15462
- * and it is exactly what an absent entry cannot say.
15463
- *
15464
- * Putting a loss counter on a cost entry would also break the reconciliation
15465
- * that gives `load-contribution` its point: contributions are subtracted from
15466
- * `metrics.node-processes-snapshot` to find processes nobody claims. A failure
15467
- * has no process.
15468
- *
15469
- * ## Why not a log line, since the counters already exist
15470
- *
15471
- * Several of these paths already counted themselves — `CaptureScheduler`'s
15472
- * per-device window, `KeyFrameCaptureLog`, `bumpCropMetric`. Every one of them
15473
- * ends in a log line, and a log line is the thing the operator asked to stop
15474
- * needing: *"possiamo armare questi errori intanto? Così al prossimo giro
15475
- * ricontrolliamo tutti questi punti"*. Reading them meant grepping Loki and
15476
- * hand-correlating timestamps, which is how a 22% thumbnail gap and a 3-hour
15477
- * media blackout were both diagnosed. The counters stay; this is where they can
15478
- * be READ.
15479
- *
15480
- * ## The rate is served with its denominator or not at all
15481
- *
15482
- * Every entry carries `attempts` and `succeeded`. A miss count alone is
15483
- * unreadable: on 2026-08-28 the enrichment-crop miss count read as "35x worse
15484
- * than yesterday" and was **flat across twelve hours** once divided by the
15485
- * successes on the same path. A surface that publishes only the numerator
15486
- * reproduces that mistake on every read.
15487
- *
15488
- * ## Shape
15489
- *
15490
- * Copied from `load-contribution.cap.ts` (`mode: 'collection'`,
15491
- * `internal: true`, `mount: { kind: 'skip' }`): no tRPC route of its own and no
15492
- * generated hooks, while `addons.listCapabilityProviders` still enumerates it
15493
- * and the hub's `CapabilityRegistry` still holds an RPC proxy per provider — so
15494
- * a forked runner's entries reach hub-main over transport that already exists.
15495
- * No new UDS message, no second registry (D3). The operator reads the assembled
15496
- * result through `system.getFailureContributions`.
15497
- */
15498
- var FailureReasonCountSchema = object({
15499
- /**
15500
- * Why the attempt did not land, in the contributor's own vocabulary —
15501
- * `worker-lease-gone`, `queue-overflow`, `timeout`, `empty-read`. The same
15502
- * strings that already appear in this repo's logs and, where one exists, the
15503
- * same string the per-track `previewMissReason` records (D276): a second
15504
- * vocabulary for the same loss would make the row and the counter
15505
- * un-joinable.
15506
- */
15507
- reason: string(),
15508
- count: number().int().nonnegative()
15509
- });
15510
- var FailureContributionSchema = object({
15511
- /**
15512
- * The failing path — `enrichment-crop`, `inference`, `plate-ocr`,
15513
- * `person-over-vehicle`. Free text, for the reason `load-contribution` keeps
15514
- * `unit` free: the families are owned by different addons and a shared enum
15515
- * is a central list that rots invisibly.
15516
- */
15517
- family: string(),
15518
- /**
15519
- * The NUMERIC device id — the same value every log line carries as
15520
- * `tags.deviceId`. Never nullable and never absent: a contributor that
15521
- * cannot name the camera must not emit the entry, because a fleet total
15522
- * cannot answer the only question anybody asks of this surface.
15523
- */
15524
- deviceId: number().int().positive(),
15525
- /**
15526
- * A second dimension inside the family: the model / step id for an inference
15527
- * timeout, so "which camera AND which model" is one read. Absent when the
15528
- * family has a single variant.
15529
- */
15530
- variant: string().optional(),
15531
- /**
15532
- * Epoch ms this counter started — the INCARNATION MARKER. A consumer
15533
- * differencing two reads must drop the interval when it changes, because the
15534
- * counter restarted from zero in a respawned runner. Same discipline as
15535
- * `LoadContribution.startedAtMs`.
15536
- */
15537
- sinceMs: number(),
15538
- /** Epoch ms it was read. `atMs - sinceMs` is the interval this covers. */
15539
- atMs: number(),
15540
- /**
15541
- * THE DENOMINATOR — every attempt on this path for this camera in the
15542
- * window. A failure count published without it is the mistake this schema
15543
- * exists to make impossible.
15544
- */
15545
- attempts: number().int().nonnegative(),
15546
- /** Attempts that landed. `attempts - succeeded` is the loss. */
15547
- succeeded: number().int().nonnegative(),
15548
- /** The loss, partitioned. Sums to `attempts - succeeded`. */
15549
- reasons: array(FailureReasonCountSchema).readonly()
15550
- });
15551
- var failureContributionCapability = {
15552
- name: "failure-contribution",
15553
- scope: "system",
15554
- mode: "collection",
15555
- internal: true,
15556
- methods: {
15557
- /**
15558
- * This addon's per-camera failure counters, read live from bounded in-RAM
15559
- * state it already keeps. Inert: no persistence, no sampling, no timer.
15560
- *
15561
- * READING NEVER RESETS. The counters are CUMULATIVE since `sinceMs`, and a
15562
- * consumer that wants a rate differences two reads. A draining read would
15563
- * make two operators with the page open each destroy half of the other's
15564
- * numbers, and `load-contribution` already settled the same question the
15565
- * same way for `cpuSeconds`.
15566
- */
15567
- list: method(_void(), array(FailureContributionSchema).readonly()) },
15568
- /** In-process only — enumerated through `addons.listCapabilityProviders`. */
15569
- mount: { kind: "skip" }
15570
- };
15571
- var LoadContributionSchema = object({
15572
- role: _enum([
15573
- "decode",
15574
- "transcode",
15575
- "recording",
15576
- "streaming",
15577
- "detection"
15578
- ]),
15579
- /**
15580
- * The NUMERIC device id — the same value every log line carries as
15581
- * `tags.deviceId`. `null` means this cost genuinely belongs to no single
15582
- * camera (a shared pool), NOT that the contributor forgot to look it up: a
15583
- * contributor that cannot name its camera must not emit the entry at all,
15584
- * because an unnamed per-camera entry is indistinguishable from a shared one
15585
- * and would quietly turn one camera's cost into everybody's.
15586
- */
15587
- deviceId: number().int().positive().nullable(),
15588
- attribution: _enum([
15589
- "measured",
15590
- "accounted",
15591
- "unattributable"
15592
- ]),
15593
- /**
15594
- * What ONE entry is, in the contributor's own words — `615/high`,
15595
- * `617/native`, `cuda:0 shared pool`. Free text because the unit differs per
15596
- * family and inventing a common one would lose the only information that
15597
- * makes two entries for the same camera distinguishable.
15598
- */
15599
- unit: string(),
15600
- /**
15601
- * The OS process this cost lives in, when there is one. Present so a
15602
- * consumer can (a) tell two generations of the same unit apart across a
15603
- * restart, and (b) subtract claimed processes from the node's process
15604
- * snapshot to see what NOBODY claimed. Absent for an entry that owns no
15605
- * process of its own.
15606
- */
15607
- pid: number().int().positive().optional(),
15608
- /**
15609
- * When this generation started. The pid's incarnation marker: a consumer
15610
- * differencing {@link LoadContributionSchema.shape.cpuSeconds} must drop the
15611
- * window when this changes, because the counter restarted from zero in a new
15612
- * process.
15613
- */
15614
- startedAtMs: number().optional(),
15615
- /**
15616
- * CUMULATIVE CPU seconds this unit has consumed since it started — user +
15617
- * system, read from the child's own `/proc/<pid>/stat` at the moment the
15618
- * contribution is asked for.
15619
- *
15620
- * Cumulative and not a rate on purpose: a rate needs a window, a window
15621
- * needs a sampler, and a new per-node sampler is the defect half of
15622
- * `docs/architecture/load-ledger.md` documents. A counter can be differenced
15623
- * by whoever already keeps a history; a rate cannot be un-averaged.
15624
- *
15625
- * Absent — never zero — on a node with no `/proc`, on a read failure, and on
15626
- * an entry with no process.
15627
- */
15628
- cpuSeconds: number().optional(),
15629
- /** Resident bytes of this unit's process, same source and same rules. */
15630
- rssBytes: number().optional()
15631
- });
15632
- var loadContributionCapability = {
15633
- name: "load-contribution",
15634
- scope: "system",
15635
- mode: "collection",
15636
- internal: true,
15637
- methods: {
15638
- /**
15639
- * This addon's own cost entries, computed live from state it already
15640
- * holds. Inert: no persistence, no sampling, no timer. It is answered on
15641
- * whatever beat the caller already has.
15642
- */
15643
- list: method(_void(), array(LoadContributionSchema).readonly()) },
15644
- /** In-process only — enumerated through `addons.listCapabilityProviders`. */
15645
- mount: { kind: "skip" }
15646
- };
15647
- /**
15648
15648
  * `login-method` — collection cap through which auth addons contribute
15649
15649
  * their pre-auth login surfaces to the login page. This is the SINGLE,
15650
15650
  * generic mechanism that supersedes the dead `auth.listProviders` reader:
@@ -21304,12 +21304,53 @@ var MediaFileKindEnum = _enum([
21304
21304
  "keyFrameSmall",
21305
21305
  "thumbnailSmall"
21306
21306
  ]);
21307
+ /**
21308
+ * One media row ON THE WIRE: what it is, how big it is, and WHERE ITS BYTES
21309
+ * ARE — never the bytes themselves.
21310
+ *
21311
+ * ## Why `url` and not `base64`
21312
+ *
21313
+ * Measured on the live hub 2026-08-30: `getTrackMedia {trackId, deviceId}`
21314
+ * with no `kinds` returned 6 rows / **3 597 219 B**, of which `keyFrame` alone
21315
+ * was **2 824 077 B** — one full-resolution frame, base64, so +33 % on the
21316
+ * wire. Forty events is ~144 MB. Every byte of it was read off disk,
21317
+ * base64-encoded, held whole in a unary tRPC envelope, and materialised in
21318
+ * hub-main's heap on the way past — for an `<img>` that would have cached it.
21319
+ *
21320
+ * `url` points at the `event-media` data plane
21321
+ * (`/addon/<addonId>/event-media/<storedKey>`), which serves the same blob
21322
+ * with an ETag and `Cache-Control: immutable`, honours conditional GETs, can
21323
+ * render a `?variant=thumb`, and streams. The hub gate in front of it requires
21324
+ * a bearer or the session cookie (`access: 'authenticated'`), so the bytes are
21325
+ * no less protected than they were inside a `view`-level cap response — see
21326
+ * `data-plane-access.ts` for the rule and the one gap it does not close
21327
+ * (per-device scoping).
21328
+ *
21329
+ * The URL is built from the row's **stored** key, which is not always its
21330
+ * published `kind`: a track's face/plate crop is stored as `crop` under
21331
+ * `('face'|'plate', '<prefix>-<trackId>')` and published as
21332
+ * `faceCrop`/`plateCrop`. `MediaStore.getByKey` knows only the stored key.
21333
+ *
21334
+ * ## `base64` is TRANSITIONAL and is going away
21335
+ *
21336
+ * It is still populated for one reason: the deployed viewer's track-detail
21337
+ * HERO tile reads it (`use-track-media-entry.ts` → `parseMediaFiles`, which
21338
+ * REQUIRES the field), and a row without it parses as a FAILED read — the red
21339
+ * triangle — not as absence. Removing the field before that viewer ships is an
21340
+ * outage, not a cleanup. Once the viewer takes its hero bytes from `url`,
21341
+ * delete this line and the `withBytes` pass-through in
21342
+ * `analytics-query-facade.ts`; nothing else reads it.
21343
+ */
21307
21344
  var MediaFileSchema = object({
21308
21345
  key: string(),
21309
21346
  kind: MediaFileKindEnum,
21310
- base64: string(),
21311
21347
  sizeBytes: number(),
21312
21348
  timestamp: number()
21349
+ }).extend({
21350
+ /** `/addon/<addonId>/event-media/<encoded stored key>`. Always present. */
21351
+ url: string(),
21352
+ /** @deprecated Transitional — see the schema docblock. Use {@link url}. */
21353
+ base64: string()
21313
21354
  });
21314
21355
  /**
21315
21356
  * One media row WITHOUT its bytes.
@@ -21321,7 +21362,9 @@ var MediaFileSchema = object({
21321
21362
  * blocks the whole view.
21322
21363
  *
21323
21364
  * `sizeBytes` is carried because it is what lets a client decide between the
21324
- * stored blob and a `?variant=thumb` rendering without fetching either.
21365
+ * stored blob and a `?variant=thumb` rendering without fetching either, and
21366
+ * `url` because a client that had to build the plane path itself is a second
21367
+ * copy of a route — the embed, the viewer and the admin UI each grew one.
21325
21368
  */
21326
21369
  var MediaFileInfoSchema = MediaFileSchema.omit({ base64: true });
21327
21370
  /**
@@ -22453,6 +22496,26 @@ var pipelineAnalyticsCapability = {
22453
22496
  deviceId: number()
22454
22497
  }), array(MediaFileInfoSchema).readonly()),
22455
22498
  /**
22499
+ * What media an EVENT has, without any of it — the twin `getEventMedia`
22500
+ * never had.
22501
+ *
22502
+ * `listTrackMedia` above got this treatment because a track's media is
22503
+ * 5-8 MB. An event's is worse per row, not better: an old-style event owns
22504
+ * a `crop` AND a native-resolution `fullFrameBoxed`, and the track DETAIL
22505
+ * modal — the one surface that legitimately shows the big kinds — unions
22506
+ * both listings to build its filmstrip. It then renders every tile from
22507
+ * the `event-media` plane by key and throws the bytes away. Measured on
22508
+ * the live hub: one event's `fullFrameBoxed` is 2 824 077 B, base64'd to
22509
+ * ~3.8 MB, allocated whole in hub-main's heap, for a list of keys.
22510
+ *
22511
+ * Same `deviceId` authorization subject as `getEventMedia`, and the same
22512
+ * rows — this is a projection of that method, never a different question.
22513
+ */
22514
+ listEventMedia: method(object({
22515
+ eventId: string(),
22516
+ deviceId: number()
22517
+ }), array(MediaFileInfoSchema).readonly()),
22518
+ /**
22456
22519
  * Search object events by text query using CLIP cosine similarity.
22457
22520
  * Encodes `text` via the `embedding-encoder` cap, queries the
22458
22521
  * `ObjectEmbeddingStore` with optional prefilters, ranks all matching
@@ -28799,10 +28862,24 @@ var FaceClusterSchema = object({
28799
28862
  size: number().int(),
28800
28863
  cohesion: number()
28801
28864
  });
28865
+ /**
28866
+ * One gallery media row: what the crop is, how big it is, and WHERE its bytes
28867
+ * are — never the bytes.
28868
+ *
28869
+ * `base64` was deleted here rather than deprecated. `MediaFile.base64` (the
28870
+ * track/event contract) is still populated because a deployed viewer requires
28871
+ * the field to parse a row at all; this method has no such reader. Its ONE
28872
+ * caller is the admin UI's detail modal, which was building
28873
+ * `data:image/jpeg;base64,…` from a row whose `key` sat right beside it, in a
28874
+ * dialog already rendering its key FRAME from the `event-media` plane.
28875
+ *
28876
+ * `url` is `/addon/<addonId>/event-media/<encoded key>`. The plane resolves a
28877
+ * media key directly, so this needed no new plane and no new access decision.
28878
+ */
28802
28879
  var MediaFileLiteSchema$1 = object({
28803
28880
  key: string(),
28804
28881
  kind: string(),
28805
- base64: string(),
28882
+ url: string(),
28806
28883
  sizeBytes: number(),
28807
28884
  timestamp: number()
28808
28885
  });
@@ -32192,10 +32269,24 @@ var PlateInfoSchema = object({
32192
32269
  */
32193
32270
  cropUrl: string().optional()
32194
32271
  });
32272
+ /**
32273
+ * One gallery media row: what the crop is, how big it is, and WHERE its bytes
32274
+ * are — never the bytes.
32275
+ *
32276
+ * `base64` was deleted here rather than deprecated. `MediaFile.base64` (the
32277
+ * track/event contract) is still populated because a deployed viewer requires
32278
+ * the field to parse a row at all; this method has no such reader. Its ONE
32279
+ * caller is the admin UI's detail modal, which was building
32280
+ * `data:image/jpeg;base64,…` from a row whose `key` sat right beside it, in a
32281
+ * dialog already rendering its key FRAME from the `event-media` plane.
32282
+ *
32283
+ * `url` is `/addon/<addonId>/event-media/<encoded key>`. The plane resolves a
32284
+ * media key directly, so this needed no new plane and no new access decision.
32285
+ */
32195
32286
  var MediaFileLiteSchema = object({
32196
32287
  key: string(),
32197
32288
  kind: string(),
32198
- base64: string(),
32289
+ url: string(),
32199
32290
  sizeBytes: number(),
32200
32291
  timestamp: number()
32201
32292
  });
@@ -39685,6 +39776,12 @@ Object.freeze({
39685
39776
  addonId: null,
39686
39777
  access: "view"
39687
39778
  },
39779
+ "pipelineAnalytics.listEventMedia": {
39780
+ capName: "pipeline-analytics",
39781
+ capScope: "device",
39782
+ addonId: null,
39783
+ access: "view"
39784
+ },
39688
39785
  "pipelineAnalytics.listGroups": {
39689
39786
  capName: "pipeline-analytics",
39690
39787
  capScope: "device",
@@ -43308,6 +43405,11 @@ Object.freeze({
43308
43405
  form: "array",
43309
43406
  optional: false
43310
43407
  }],
43408
+ "pipelineAnalytics.listEventMedia": [{
43409
+ name: "deviceId",
43410
+ form: "single",
43411
+ optional: false
43412
+ }],
43311
43413
  "pipelineAnalytics.listGroups": [{
43312
43414
  name: "deviceIds",
43313
43415
  form: "array",
@@ -1,5 +1,5 @@
1
1
  import { h as e, l as t, u as n, y as r } from "./_virtual_mf___mfe_internal__addon_osd_manager_page__loadShare__react__loadShare__.js-Bs1t18EM.mjs";
2
- import { o as i, s as a } from "./responsive-BAE2Alvc.mjs";
2
+ import { o as i, s as a } from "./responsive-DC2YNF2r.mjs";
3
3
  import { n as o, r as s, t as c } from "./_virtual_mf___mfe_internal__addon_osd_manager_page__loadShare__react_mf_1_jsx_mf_2_runtime__loadShare__.js-DalfdIDw.mjs";
4
4
  var l = a("chevron-down", [["path", {
5
5
  d: "m6 9 6 6 6-6",
@@ -1,2 +1,2 @@
1
- import { n as e, t } from "./virtual_mf-REMOTE_ENTRY_ID___mfe_internal__addon_osd_manager_page__remoteEntry_js-hPck03Nc.mjs";
1
+ import { n as e, t } from "./virtual_mf-REMOTE_ENTRY_ID___mfe_internal__addon_osd_manager_page__remoteEntry_js-B-XuFKdU.mjs";
2
2
  export { t as get, e as init };
@@ -1,6 +1,6 @@
1
1
  import { c as e, g as t, h as n, l as r, n as i, p as a, r as o, t as s, u as c, y as l } from "./_virtual_mf___mfe_internal__addon_osd_manager_page__loadShare__react__loadShare__.js-Bs1t18EM.mjs";
2
2
  import "./_virtual_mf___mfe_internal__addon_osd_manager_page__loadShare__react_mf_1_jsx_mf_2_runtime__loadShare__.js-DalfdIDw.mjs";
3
- import { n as u } from "./_virtual_mf___mfe_internal__addon_osd_manager_page__loadShare___mf_0_camstack_mf_1_types__loadShare__.js-CnoMYUFR.mjs";
3
+ import { n as u } from "./_virtual_mf___mfe_internal__addon_osd_manager_page__loadShare___mf_0_camstack_mf_1_types__loadShare__.js-Blhr4EyN.mjs";
4
4
  //#region ../ui-library/node_modules/lucide-react/dist/esm/shared/src/utils/mergeClasses.js
5
5
  l();
6
6
  var d = (...e) => e.filter((e, t, n) => !!e && e.trim() !== "" && n.indexOf(e) === t).join(" ").trim(), f = (e) => e.replace(/([a-z0-9])([A-Z])/g, "$1-$2").toLowerCase(), p = (e) => e.replace(/^([A-Z])|[\s-_]+(\w)/g, (e, t, n) => n ? n.toUpperCase() : t.toLowerCase()), m = (e) => {
@@ -1,4 +1,4 @@
1
- import { s as e } from "./responsive-BAE2Alvc.mjs";
1
+ import { s as e } from "./responsive-DC2YNF2r.mjs";
2
2
  var t = e("eye-off", [
3
3
  ["path", {
4
4
  d: "M10.733 5.076a10.744 10.744 0 0 1 11.205 6.575 1 1 0 0 1 0 .696 10.747 10.747 0 0 1-1.444 2.49",
@@ -1,4 +1,4 @@
1
- import { s as e } from "./responsive-BAE2Alvc.mjs";
1
+ import { s as e } from "./responsive-DC2YNF2r.mjs";
2
2
  var t = e("trash-2", [
3
3
  ["path", {
4
4
  d: "M10 11v6",
@@ -1,5 +1,5 @@
1
1
  import { c as e, h as t, p as n, y as r } from "./_virtual_mf___mfe_internal__addon_osd_manager_page__loadShare__react__loadShare__.js-Bs1t18EM.mjs";
2
- import { s as i } from "./responsive-BAE2Alvc.mjs";
2
+ import { s as i } from "./responsive-DC2YNF2r.mjs";
3
3
  var a = i("camera", [["path", {
4
4
  d: "M13.997 4a2 2 0 0 1 1.76 1.05l.486.9A2 2 0 0 0 18.003 7H20a2 2 0 0 1 2 2v9a2 2 0 0 1-2 2H4a2 2 0 0 1-2-2V9a2 2 0 0 1 2-2h1.997a2 2 0 0 0 1.759-1.048l.489-.904A2 2 0 0 1 10.004 4z",
5
5
  key: "18u6gg"
@@ -2753,7 +2753,7 @@ async function rr(e) {
2753
2753
  }
2754
2754
  }
2755
2755
  async function ir() {
2756
- return tr ||= rr(() => import("./_virtual_mf-localSharedImportMap___mfe_internal__addon_osd_manager_page-BfqPLLgE.mjs")).catch((e) => {
2756
+ return tr ||= rr(() => import("./_virtual_mf-localSharedImportMap___mfe_internal__addon_osd_manager_page-C4iHNnmw.mjs")).catch((e) => {
2757
2757
  throw tr = void 0, e;
2758
2758
  }), tr;
2759
2759
  }
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@camstack/addon-osd-manager",
3
- "version": "0.1.39",
3
+ "version": "0.1.40",
4
4
  "description": "Binds camera on-screen-display slots to live state and recognitions",
5
5
  "keywords": [
6
6
  "camstack",