@camstack/addon-remote-storage 1.2.34 → 1.2.36

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/s3.addon.js CHANGED
@@ -2,7 +2,7 @@ Object.defineProperties(exports, {
2
2
  __esModule: { value: true },
3
3
  [Symbol.toStringTag]: { value: "Module" }
4
4
  });
5
- const require_shared = require("./shared-BkgFJ2q-.js");
5
+ const require_shared = require("./shared-CWzgutnW.js");
6
6
  let node_stream = require("node:stream");
7
7
  let _aws_sdk_client_s3 = require("@aws-sdk/client-s3");
8
8
  let _aws_sdk_lib_storage = require("@aws-sdk/lib-storage");
package/dist/s3.addon.mjs CHANGED
@@ -1,4 +1,4 @@
1
- import { c as BaseAddon, i as rearmIdleAbort, n as getOptionalBasePath, o as scheduleIdleAbort, s as storageProviderCapability, t as createSessionId } from "./shared-JInb-Tpq.mjs";
1
+ import { c as BaseAddon, i as rearmIdleAbort, n as getOptionalBasePath, o as scheduleIdleAbort, s as storageProviderCapability, t as createSessionId } from "./shared-AzvwyoO3.mjs";
2
2
  import { PassThrough } from "node:stream";
3
3
  import { DeleteObjectCommand, GetObjectCommand, HeadBucketCommand, HeadObjectCommand, ListObjectsV2Command, PutObjectCommand, S3Client } from "@aws-sdk/client-s3";
4
4
  import { Upload } from "@aws-sdk/lib-storage";
@@ -2,7 +2,7 @@ Object.defineProperties(exports, {
2
2
  __esModule: { value: true },
3
3
  [Symbol.toStringTag]: { value: "Module" }
4
4
  });
5
- const require_shared = require("./shared-BkgFJ2q-.js");
5
+ const require_shared = require("./shared-CWzgutnW.js");
6
6
  let ssh2 = require("ssh2");
7
7
  let node_path = require("node:path");
8
8
  node_path = require_shared.__toESM(node_path);
@@ -1,4 +1,4 @@
1
- import { a as safeJoinRemotePath, c as BaseAddon, i as rearmIdleAbort, o as scheduleIdleAbort, r as getRequiredBasePath, s as storageProviderCapability, t as createSessionId } from "./shared-JInb-Tpq.mjs";
1
+ import { a as safeJoinRemotePath, c as BaseAddon, i as rearmIdleAbort, o as scheduleIdleAbort, r as getRequiredBasePath, s as storageProviderCapability, t as createSessionId } from "./shared-AzvwyoO3.mjs";
2
2
  import { Client } from "ssh2";
3
3
  import * as path from "node:path";
4
4
  //#region src/providers/sftp/sftp-config-schema.ts
@@ -1,6 +1,6 @@
1
1
  import { randomUUID } from "node:crypto";
2
2
  import * as path from "node:path";
3
- //#region ../types/dist/event-category-CIa_iT6b.mjs
3
+ //#region ../types/dist/event-category-BZL-fdNj.mjs
4
4
  var EventCategory = /* @__PURE__ */ function(EventCategory) {
5
5
  EventCategory["SystemBoot"] = "system.boot";
6
6
  EventCategory["SystemAddonsReady"] = "system.addons-ready";
@@ -437,7 +437,7 @@ var EventCategory = /* @__PURE__ */ function(EventCategory) {
437
437
  EventCategory["MetricsNodeResourcesSnapshot"] = "metrics.node-resources-snapshot";
438
438
  /**
439
439
  * Periodic per-node process-tree snapshot (camstack-related pids
440
- * with ghost / managed / root classification). Emitted ~0.2 Hz by
440
+ * with root / managed / system classification). Emitted ~0.2 Hz by
441
441
  * the metrics-provider addon. Drives the Cluster → Processes tab
442
442
  * without polling `metricsProvider.listNodeProcesses`.
443
443
  */
@@ -11111,6 +11111,19 @@ var SettingsRecordSchema = object({
11111
11111
  data: record(string(), unknown())
11112
11112
  });
11113
11113
  /**
11114
+ * One record of a BULK insert — {@link SettingsRecordSchema} with the id made
11115
+ * optional.
11116
+ *
11117
+ * A separate schema rather than loosening the shared one: every other method
11118
+ * on this cap addresses a row BY its id, and making that field optional
11119
+ * everywhere would turn a forgotten key into a silently generated one on
11120
+ * `update` and `delete` as well.
11121
+ */
11122
+ var BulkRecordSchema = object({
11123
+ id: string().optional(),
11124
+ data: record(string(), unknown())
11125
+ });
11126
+ /**
11114
11127
  * Column declaration for a structured (SQL-backed) collection.
11115
11128
  *
11116
11129
  * Logical types — the backend translates each to the matching SQLite
@@ -11167,6 +11180,10 @@ method(object({
11167
11180
  collection: string(),
11168
11181
  record: SettingsRecordSchema
11169
11182
  }), _void(), { kind: "mutation" }), method(object({
11183
+ namespace: string().optional(),
11184
+ collection: string(),
11185
+ records: array(BulkRecordSchema).readonly()
11186
+ }), object({ inserted: number().int() }), { kind: "mutation" }), method(object({
11170
11187
  namespace: string().optional(),
11171
11188
  collection: string(),
11172
11189
  id: string(),
@@ -11275,6 +11292,13 @@ method(_void(), EngineInfoSchema, { auth: "admin" }), method(object({
11275
11292
  }), _void(), {
11276
11293
  kind: "mutation",
11277
11294
  auth: "admin"
11295
+ }), method(object({
11296
+ namespace: string().optional(),
11297
+ collection: string(),
11298
+ records: array(BulkRecordSchema).readonly()
11299
+ }), object({ inserted: number().int() }), {
11300
+ kind: "mutation",
11301
+ auth: "admin"
11278
11302
  }), method(object({
11279
11303
  namespace: string().optional(),
11280
11304
  collection: string(),
@@ -13043,6 +13067,68 @@ method(LogEntrySchema, _void(), { kind: "mutation" }), method(object({
13043
13067
  limit: number().optional(),
13044
13068
  tags: record(string(), string()).optional()
13045
13069
  }), array(LogEntrySchema).readonly());
13070
+ var LoadContributionSchema = object({
13071
+ role: _enum([
13072
+ "decode",
13073
+ "transcode",
13074
+ "recording",
13075
+ "streaming",
13076
+ "detection"
13077
+ ]),
13078
+ /**
13079
+ * The NUMERIC device id — the same value every log line carries as
13080
+ * `tags.deviceId`. `null` means this cost genuinely belongs to no single
13081
+ * camera (a shared pool), NOT that the contributor forgot to look it up: a
13082
+ * contributor that cannot name its camera must not emit the entry at all,
13083
+ * because an unnamed per-camera entry is indistinguishable from a shared one
13084
+ * and would quietly turn one camera's cost into everybody's.
13085
+ */
13086
+ deviceId: number().int().positive().nullable(),
13087
+ attribution: _enum([
13088
+ "measured",
13089
+ "accounted",
13090
+ "unattributable"
13091
+ ]),
13092
+ /**
13093
+ * What ONE entry is, in the contributor's own words — `615/high`,
13094
+ * `617/native`, `cuda:0 shared pool`. Free text because the unit differs per
13095
+ * family and inventing a common one would lose the only information that
13096
+ * makes two entries for the same camera distinguishable.
13097
+ */
13098
+ unit: string(),
13099
+ /**
13100
+ * The OS process this cost lives in, when there is one. Present so a
13101
+ * consumer can (a) tell two generations of the same unit apart across a
13102
+ * restart, and (b) subtract claimed processes from the node's process
13103
+ * snapshot to see what NOBODY claimed. Absent for an entry that owns no
13104
+ * process of its own.
13105
+ */
13106
+ pid: number().int().positive().optional(),
13107
+ /**
13108
+ * When this generation started. The pid's incarnation marker: a consumer
13109
+ * differencing {@link LoadContributionSchema.shape.cpuSeconds} must drop the
13110
+ * window when this changes, because the counter restarted from zero in a new
13111
+ * process.
13112
+ */
13113
+ startedAtMs: number().optional(),
13114
+ /**
13115
+ * CUMULATIVE CPU seconds this unit has consumed since it started — user +
13116
+ * system, read from the child's own `/proc/<pid>/stat` at the moment the
13117
+ * contribution is asked for.
13118
+ *
13119
+ * Cumulative and not a rate on purpose: a rate needs a window, a window
13120
+ * needs a sampler, and a new per-node sampler is the defect half of
13121
+ * `docs/architecture/load-ledger.md` documents. A counter can be differenced
13122
+ * by whoever already keeps a history; a rate cannot be un-averaged.
13123
+ *
13124
+ * Absent — never zero — on a node with no `/proc`, on a read failure, and on
13125
+ * an entry with no process.
13126
+ */
13127
+ cpuSeconds: number().optional(),
13128
+ /** Resident bytes of this unit's process, same source and same rules. */
13129
+ rssBytes: number().optional()
13130
+ });
13131
+ method(_void(), array(LoadContributionSchema).readonly());
13046
13132
  /**
13047
13133
  * `login-method` — collection cap through which auth addons contribute
13048
13134
  * their pre-auth login surfaces to the login page. This is the SINGLE,
@@ -13246,8 +13332,7 @@ var NodeProcessSchema = object({
13246
13332
  classification: _enum([
13247
13333
  "root",
13248
13334
  "managed",
13249
- "system",
13250
- "ghost"
13335
+ "system"
13251
13336
  ]),
13252
13337
  /** `$process` addon binding when `managed`, else null. */
13253
13338
  addonId: string().nullable(),
@@ -13255,22 +13340,39 @@ var NodeProcessSchema = object({
13255
13340
  nodeId: string().nullable(),
13256
13341
  /** Truncated command line. */
13257
13342
  command: string(),
13343
+ /**
13344
+ * `ps pcpu` — CPU averaged over the process's WHOLE LIFETIME, not a rate.
13345
+ * On a runner up for days it barely moves. Fine as a column, useless as a
13346
+ * series: use `cpuMainPercent + cpuGcPercent` for anything time-varying.
13347
+ */
13258
13348
  cpuPercent: number(),
13259
13349
  memoryRssBytes: number(),
13350
+ /**
13351
+ * Instantaneous CPU% of the process's own threads over the last
13352
+ * process-snapshot window, from a `/proc/<pid>/task/*` tick delta.
13353
+ *
13354
+ * `null` = UNKNOWN, never zero: no previous sample yet (first tick after
13355
+ * boot), the pid was recycled, or this node is not Linux.
13356
+ */
13357
+ cpuMainPercent: number().nullable(),
13358
+ /**
13359
+ * Instantaneous CPU% of V8's `V8Worker` platform pool over the same window.
13360
+ *
13361
+ * This is the number that rewrote the 2026-08-27 diagnosis — hub-main 73%,
13362
+ * `stream-broker` 61% (`docs/architecture/load-ledger.md`). A CPU chart that
13363
+ * does not separate it from `cpuMainPercent` shows "busy" where the truth is
13364
+ * "allocating too much".
13365
+ *
13366
+ * Concurrent GC is the dominant tenant of that pool but not the only one
13367
+ * (background compilation runs there too), so it is reported as
13368
+ * "GC / V8 helpers" rather than as pure collection time. `null` has the same
13369
+ * meaning as on `cpuMainPercent`.
13370
+ */
13371
+ cpuGcPercent: number().nullable(),
13372
+ /** Threads seen in the tick scan. `null` under the same conditions. */
13373
+ threadCount: number().nullable(),
13260
13374
  /** Wall-clock uptime (seconds). Parsed from `ps etime`. */
13261
- uptimeSec: number(),
13262
- /** True when ancestor walk reaches `ppid=1` (reparented to init/launchd). */
13263
- orphaned: boolean()
13264
- });
13265
- var KillProcessInputSchema = object({
13266
- pid: number(),
13267
- /** Force = SIGKILL. Default is SIGTERM. */
13268
- force: boolean().optional()
13269
- });
13270
- var KillProcessResultSchema = object({
13271
- success: boolean(),
13272
- reason: string().optional(),
13273
- signal: _enum(["SIGTERM", "SIGKILL"]).optional()
13375
+ uptimeSec: number()
13274
13376
  });
13275
13377
  var DumpHeapSnapshotInputSchema = object({
13276
13378
  /** The addon whose runner should dump a heap snapshot. */
@@ -13283,6 +13385,104 @@ var DumpHeapSnapshotResultSchema = object({
13283
13385
  pid: number().optional(),
13284
13386
  reason: string().optional()
13285
13387
  });
13388
+ /**
13389
+ * One point of one function's series.
13390
+ *
13391
+ * The unsuffixed fields are the bucket's **MAXIMUM**, and that choice is the
13392
+ * point of the whole surface. The two obvious reductions both lie: a mean per
13393
+ * bucket smears a spike away, and taking every Nth sample skips it outright.
13394
+ * Either would give us a tool built to find peaks that does not show peaks.
13395
+ * `...Min` carries the other end, `samples` says how many raw snapshots folded
13396
+ * into the bucket, and a mean stays derivable where it is wanted.
13397
+ *
13398
+ * An UNREDUCED point is a one-sample bucket: `samples === 1` and each `...Min`
13399
+ * equals its unsuffixed twin. Reduced and unreduced are the same shape, so a
13400
+ * caller cannot tell which it received — which is what "one reader" means.
13401
+ */
13402
+ var LoadPointSchema = object({
13403
+ /** Bucket START, or the snapshot's own timestamp when unreduced. */
13404
+ atMs: number(),
13405
+ /** Raw snapshots in this bucket. Never 0 — AN EMPTY BUCKET IS ABSENT. */
13406
+ samples: number().int(),
13407
+ /**
13408
+ * `null` = UNKNOWN and it PROPAGATES: a bucket is null unless every process
13409
+ * of every snapshot in it reported a thread split. A partial sum is a
13410
+ * smaller number that looks exactly as real as a complete one.
13411
+ */
13412
+ cpuMainPercent: number().nullable(),
13413
+ cpuMainPercentMin: number().nullable(),
13414
+ cpuGcPercent: number().nullable(),
13415
+ cpuGcPercentMin: number().nullable(),
13416
+ /** Lifetime-average CPU%, summed. Always known — and never a rate. */
13417
+ cpuLifetimePercent: number(),
13418
+ cpuLifetimePercentMin: number(),
13419
+ memoryRssBytes: number(),
13420
+ memoryRssBytesMin: number(),
13421
+ processCount: number().int(),
13422
+ processCountMin: number().int()
13423
+ });
13424
+ /** One function's series. `key` is an addonId, `__root__` or `__unattributed__`. */
13425
+ var LoadFunctionSeriesSchema = object({
13426
+ key: string(),
13427
+ kind: _enum([
13428
+ "addon",
13429
+ "root",
13430
+ "unattributed"
13431
+ ]),
13432
+ /** Oldest-first. A missing interval is MISSING — never zero-filled. */
13433
+ points: array(LoadPointSchema).readonly()
13434
+ });
13435
+ var NodeLoadSeriesSchema = object({
13436
+ nodeId: string(),
13437
+ /** One entry per function seen in the window, heaviest-first. */
13438
+ series: array(LoadFunctionSeriesSchema).readonly(),
13439
+ /**
13440
+ * Width of one returned bucket, in ms. Equals the sampling cadence when no
13441
+ * reduction was needed — so a caller can always say what one point covers
13442
+ * without having to know whether it was reduced.
13443
+ */
13444
+ bucketMs: number(),
13445
+ /** Raw snapshots that went into this answer, across both tiers. */
13446
+ retainedSamples: number(),
13447
+ /** Oldest snapshot represented, or `null` when nothing is retained. */
13448
+ oldestAtMs: number().nullable(),
13449
+ /** The fixed sampling cadence in force on the cluster, in ms. */
13450
+ cadenceMs: number(),
13451
+ /**
13452
+ * Did the DURABLE tier contribute? `false` means the answer is the hot ring
13453
+ * alone — an agent (which holds no table), or a store that refused.
13454
+ * Reported because "the last hour" and "the last six hours" are different
13455
+ * questions and an operator must not have to guess which was answered.
13456
+ */
13457
+ durable: boolean()
13458
+ });
13459
+ var GetLoadSeriesInputSchema = object({
13460
+ /**
13461
+ * The node whose series is wanted.
13462
+ *
13463
+ * NOT named `nodeId`: the generated cap router strips a top-level
13464
+ * `nodeId` from every method input and uses it to ROUTE the call to
13465
+ * that node's provider (`generated-cap-routers.ts`). A series target
13466
+ * called `nodeId` would silently become a routing pin and never reach
13467
+ * the provider. The hub holds every node it hears from, so the
13468
+ * ordinary call is unpinned — answered by the hub, for any node.
13469
+ */
13470
+ forNodeId: string(),
13471
+ /**
13472
+ * EXCLUSIVE lower bound. A caller passes the newest `atMs` it already
13473
+ * holds and receives only what it is missing, so seeding a live chart
13474
+ * from this method cannot double a point already drawn.
13475
+ */
13476
+ sinceMs: number().optional(),
13477
+ /**
13478
+ * Most points the caller wants PER FUNCTION. The window is reduced to fit,
13479
+ * preserving min and max per bucket.
13480
+ *
13481
+ * Absent means NO reduction — legitimate for a short window and a trap for a
13482
+ * long one, which is why a chart passes its own pixel width.
13483
+ */
13484
+ maxPoints: number().int().positive().optional()
13485
+ });
13286
13486
  var SystemMetricsSchema = object({
13287
13487
  cpuPercent: number(),
13288
13488
  memoryPercent: number(),
@@ -13293,10 +13493,7 @@ var SystemMetricsSchema = object({
13293
13493
  gpuPercent: number().optional(),
13294
13494
  gpuMemoryPercent: number().optional()
13295
13495
  });
13296
- method(_void(), SystemResourceSnapshotSchema), method(_void(), SystemResourceSnapshotSchema.nullable()), method(_void(), SystemMetricsSchema), method(object({ dirPath: string() }), DiskSpaceInfoSchema), method(_void(), MetricsGpuInfoSchema.nullable()), method(_void(), number().nullable()), method(object({ pids: array(number()) }), array(PidResourceStatsSchema)), method(_void(), array(AddonInstanceSchema).readonly()), method(object({ addonId: string() }), PidResourceStatsSchema.nullable()), method(_void(), array(NodeProcessSchema).readonly()), method(KillProcessInputSchema, KillProcessResultSchema, {
13297
- kind: "mutation",
13298
- auth: "admin"
13299
- }), method(DumpHeapSnapshotInputSchema, DumpHeapSnapshotResultSchema, {
13496
+ method(_void(), SystemResourceSnapshotSchema), method(_void(), SystemResourceSnapshotSchema.nullable()), method(_void(), SystemMetricsSchema), method(object({ dirPath: string() }), DiskSpaceInfoSchema), method(_void(), MetricsGpuInfoSchema.nullable()), method(_void(), number().nullable()), method(object({ pids: array(number()) }), array(PidResourceStatsSchema)), method(_void(), array(AddonInstanceSchema).readonly()), method(object({ addonId: string() }), PidResourceStatsSchema.nullable()), method(_void(), array(NodeProcessSchema).readonly()), method(GetLoadSeriesInputSchema, NodeLoadSeriesSchema), method(DumpHeapSnapshotInputSchema, DumpHeapSnapshotResultSchema, {
13300
13497
  kind: "mutation",
13301
13498
  auth: "admin"
13302
13499
  });
@@ -26659,6 +26856,15 @@ var LoggingSettingsPatchSchema = object({
26659
26856
  * authority over the whole hierarchy and answers for every layer, so the
26660
26857
  * layer selector needs a name the transport does not already own.
26661
26858
  */
26859
+ /**
26860
+ * One contribution, plus WHO reported it.
26861
+ *
26862
+ * The addon and node are added by the hub as it enumerates providers, never by
26863
+ * the contributor: an addon reporting its own identity could report somebody
26864
+ * else's, and the whole point of this surface is that no claim is made by
26865
+ * anyone but its owner.
26866
+ */
26867
+ var ReportedLoadContributionSchema = LoadContributionSchema.extend({ addonId: string() });
26662
26868
  var GetLoggingSettingsInputSchema = object({
26663
26869
  scopeNodeId: string().optional(),
26664
26870
  /**
@@ -26717,7 +26923,7 @@ method(_void(), FeatureManifestSchema), method(_void(), HealthStatusSchema), met
26717
26923
  }), method(_void(), SiteLocationStatusSchema, {
26718
26924
  kind: "mutation",
26719
26925
  auth: "admin"
26720
- }), method(_void(), RequestCensusStatusSchema, { auth: "admin" }), method(GetLoggingSettingsInputSchema, LoggingSettingsStateSchema, { auth: "admin" }), method(SetLoggingSettingsInputSchema, LoggingSettingsStateSchema, {
26926
+ }), method(_void(), RequestCensusStatusSchema, { auth: "admin" }), method(_void(), array(ReportedLoadContributionSchema).readonly(), { auth: "admin" }), method(GetLoggingSettingsInputSchema, LoggingSettingsStateSchema, { auth: "admin" }), method(SetLoggingSettingsInputSchema, LoggingSettingsStateSchema, {
26721
26927
  kind: "mutation",
26722
26928
  auth: "admin"
26723
26929
  });
@@ -28333,6 +28539,12 @@ Object.freeze({
28333
28539
  addonId: null,
28334
28540
  access: "create"
28335
28541
  },
28542
+ "dataStoreProvider.insertMany": {
28543
+ capName: "data-store-provider",
28544
+ capScope: "system",
28545
+ addonId: null,
28546
+ access: "create"
28547
+ },
28336
28548
  "dataStoreProvider.isEmpty": {
28337
28549
  capName: "data-store-provider",
28338
28550
  capScope: "system",
@@ -29647,6 +29859,12 @@ Object.freeze({
29647
29859
  addonId: null,
29648
29860
  access: "create"
29649
29861
  },
29862
+ "loadContribution.list": {
29863
+ capName: "load-contribution",
29864
+ capScope: "system",
29865
+ addonId: null,
29866
+ access: "view"
29867
+ },
29650
29868
  "localNetwork.downloadCa": {
29651
29869
  capName: "local-network",
29652
29870
  capScope: "system",
@@ -29947,17 +30165,17 @@ Object.freeze({
29947
30165
  addonId: null,
29948
30166
  access: "view"
29949
30167
  },
29950
- "metricsProvider.getProcessStats": {
30168
+ "metricsProvider.getLoadSeries": {
29951
30169
  capName: "metrics-provider",
29952
30170
  capScope: "system",
29953
30171
  addonId: null,
29954
30172
  access: "view"
29955
30173
  },
29956
- "metricsProvider.killProcess": {
30174
+ "metricsProvider.getProcessStats": {
29957
30175
  capName: "metrics-provider",
29958
30176
  capScope: "system",
29959
30177
  addonId: null,
29960
- access: "create"
30178
+ access: "view"
29961
30179
  },
29962
30180
  "metricsProvider.listAddonInstances": {
29963
30181
  capName: "metrics-provider",
@@ -31969,6 +32187,12 @@ Object.freeze({
31969
32187
  addonId: null,
31970
32188
  access: "create"
31971
32189
  },
32190
+ "settingsStore.insertMany": {
32191
+ capName: "settings-store",
32192
+ capScope: "system",
32193
+ addonId: null,
32194
+ access: "create"
32195
+ },
31972
32196
  "settingsStore.isEmpty": {
31973
32197
  capName: "settings-store",
31974
32198
  capScope: "system",
@@ -32581,6 +32805,12 @@ Object.freeze({
32581
32805
  addonId: null,
32582
32806
  access: "create"
32583
32807
  },
32808
+ "system.getLoadContributions": {
32809
+ capName: "system",
32810
+ capScope: "system",
32811
+ addonId: null,
32812
+ access: "view"
32813
+ },
32584
32814
  "system.getLoggingSettings": {
32585
32815
  capName: "system",
32586
32816
  capScope: "system",
@@ -23,7 +23,7 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
23
23
  let node_crypto = require("node:crypto");
24
24
  let node_path = require("node:path");
25
25
  node_path = __toESM(node_path);
26
- //#region ../types/dist/event-category-CIa_iT6b.mjs
26
+ //#region ../types/dist/event-category-BZL-fdNj.mjs
27
27
  var EventCategory = /* @__PURE__ */ function(EventCategory) {
28
28
  EventCategory["SystemBoot"] = "system.boot";
29
29
  EventCategory["SystemAddonsReady"] = "system.addons-ready";
@@ -460,7 +460,7 @@ var EventCategory = /* @__PURE__ */ function(EventCategory) {
460
460
  EventCategory["MetricsNodeResourcesSnapshot"] = "metrics.node-resources-snapshot";
461
461
  /**
462
462
  * Periodic per-node process-tree snapshot (camstack-related pids
463
- * with ghost / managed / root classification). Emitted ~0.2 Hz by
463
+ * with root / managed / system classification). Emitted ~0.2 Hz by
464
464
  * the metrics-provider addon. Drives the Cluster → Processes tab
465
465
  * without polling `metricsProvider.listNodeProcesses`.
466
466
  */
@@ -11134,6 +11134,19 @@ var SettingsRecordSchema = object({
11134
11134
  data: record(string(), unknown())
11135
11135
  });
11136
11136
  /**
11137
+ * One record of a BULK insert — {@link SettingsRecordSchema} with the id made
11138
+ * optional.
11139
+ *
11140
+ * A separate schema rather than loosening the shared one: every other method
11141
+ * on this cap addresses a row BY its id, and making that field optional
11142
+ * everywhere would turn a forgotten key into a silently generated one on
11143
+ * `update` and `delete` as well.
11144
+ */
11145
+ var BulkRecordSchema = object({
11146
+ id: string().optional(),
11147
+ data: record(string(), unknown())
11148
+ });
11149
+ /**
11137
11150
  * Column declaration for a structured (SQL-backed) collection.
11138
11151
  *
11139
11152
  * Logical types — the backend translates each to the matching SQLite
@@ -11190,6 +11203,10 @@ method(object({
11190
11203
  collection: string(),
11191
11204
  record: SettingsRecordSchema
11192
11205
  }), _void(), { kind: "mutation" }), method(object({
11206
+ namespace: string().optional(),
11207
+ collection: string(),
11208
+ records: array(BulkRecordSchema).readonly()
11209
+ }), object({ inserted: number().int() }), { kind: "mutation" }), method(object({
11193
11210
  namespace: string().optional(),
11194
11211
  collection: string(),
11195
11212
  id: string(),
@@ -11298,6 +11315,13 @@ method(_void(), EngineInfoSchema, { auth: "admin" }), method(object({
11298
11315
  }), _void(), {
11299
11316
  kind: "mutation",
11300
11317
  auth: "admin"
11318
+ }), method(object({
11319
+ namespace: string().optional(),
11320
+ collection: string(),
11321
+ records: array(BulkRecordSchema).readonly()
11322
+ }), object({ inserted: number().int() }), {
11323
+ kind: "mutation",
11324
+ auth: "admin"
11301
11325
  }), method(object({
11302
11326
  namespace: string().optional(),
11303
11327
  collection: string(),
@@ -13066,6 +13090,68 @@ method(LogEntrySchema, _void(), { kind: "mutation" }), method(object({
13066
13090
  limit: number().optional(),
13067
13091
  tags: record(string(), string()).optional()
13068
13092
  }), array(LogEntrySchema).readonly());
13093
+ var LoadContributionSchema = object({
13094
+ role: _enum([
13095
+ "decode",
13096
+ "transcode",
13097
+ "recording",
13098
+ "streaming",
13099
+ "detection"
13100
+ ]),
13101
+ /**
13102
+ * The NUMERIC device id — the same value every log line carries as
13103
+ * `tags.deviceId`. `null` means this cost genuinely belongs to no single
13104
+ * camera (a shared pool), NOT that the contributor forgot to look it up: a
13105
+ * contributor that cannot name its camera must not emit the entry at all,
13106
+ * because an unnamed per-camera entry is indistinguishable from a shared one
13107
+ * and would quietly turn one camera's cost into everybody's.
13108
+ */
13109
+ deviceId: number().int().positive().nullable(),
13110
+ attribution: _enum([
13111
+ "measured",
13112
+ "accounted",
13113
+ "unattributable"
13114
+ ]),
13115
+ /**
13116
+ * What ONE entry is, in the contributor's own words — `615/high`,
13117
+ * `617/native`, `cuda:0 shared pool`. Free text because the unit differs per
13118
+ * family and inventing a common one would lose the only information that
13119
+ * makes two entries for the same camera distinguishable.
13120
+ */
13121
+ unit: string(),
13122
+ /**
13123
+ * The OS process this cost lives in, when there is one. Present so a
13124
+ * consumer can (a) tell two generations of the same unit apart across a
13125
+ * restart, and (b) subtract claimed processes from the node's process
13126
+ * snapshot to see what NOBODY claimed. Absent for an entry that owns no
13127
+ * process of its own.
13128
+ */
13129
+ pid: number().int().positive().optional(),
13130
+ /**
13131
+ * When this generation started. The pid's incarnation marker: a consumer
13132
+ * differencing {@link LoadContributionSchema.shape.cpuSeconds} must drop the
13133
+ * window when this changes, because the counter restarted from zero in a new
13134
+ * process.
13135
+ */
13136
+ startedAtMs: number().optional(),
13137
+ /**
13138
+ * CUMULATIVE CPU seconds this unit has consumed since it started — user +
13139
+ * system, read from the child's own `/proc/<pid>/stat` at the moment the
13140
+ * contribution is asked for.
13141
+ *
13142
+ * Cumulative and not a rate on purpose: a rate needs a window, a window
13143
+ * needs a sampler, and a new per-node sampler is the defect half of
13144
+ * `docs/architecture/load-ledger.md` documents. A counter can be differenced
13145
+ * by whoever already keeps a history; a rate cannot be un-averaged.
13146
+ *
13147
+ * Absent — never zero — on a node with no `/proc`, on a read failure, and on
13148
+ * an entry with no process.
13149
+ */
13150
+ cpuSeconds: number().optional(),
13151
+ /** Resident bytes of this unit's process, same source and same rules. */
13152
+ rssBytes: number().optional()
13153
+ });
13154
+ method(_void(), array(LoadContributionSchema).readonly());
13069
13155
  /**
13070
13156
  * `login-method` — collection cap through which auth addons contribute
13071
13157
  * their pre-auth login surfaces to the login page. This is the SINGLE,
@@ -13269,8 +13355,7 @@ var NodeProcessSchema = object({
13269
13355
  classification: _enum([
13270
13356
  "root",
13271
13357
  "managed",
13272
- "system",
13273
- "ghost"
13358
+ "system"
13274
13359
  ]),
13275
13360
  /** `$process` addon binding when `managed`, else null. */
13276
13361
  addonId: string().nullable(),
@@ -13278,22 +13363,39 @@ var NodeProcessSchema = object({
13278
13363
  nodeId: string().nullable(),
13279
13364
  /** Truncated command line. */
13280
13365
  command: string(),
13366
+ /**
13367
+ * `ps pcpu` — CPU averaged over the process's WHOLE LIFETIME, not a rate.
13368
+ * On a runner up for days it barely moves. Fine as a column, useless as a
13369
+ * series: use `cpuMainPercent + cpuGcPercent` for anything time-varying.
13370
+ */
13281
13371
  cpuPercent: number(),
13282
13372
  memoryRssBytes: number(),
13373
+ /**
13374
+ * Instantaneous CPU% of the process's own threads over the last
13375
+ * process-snapshot window, from a `/proc/<pid>/task/*` tick delta.
13376
+ *
13377
+ * `null` = UNKNOWN, never zero: no previous sample yet (first tick after
13378
+ * boot), the pid was recycled, or this node is not Linux.
13379
+ */
13380
+ cpuMainPercent: number().nullable(),
13381
+ /**
13382
+ * Instantaneous CPU% of V8's `V8Worker` platform pool over the same window.
13383
+ *
13384
+ * This is the number that rewrote the 2026-08-27 diagnosis — hub-main 73%,
13385
+ * `stream-broker` 61% (`docs/architecture/load-ledger.md`). A CPU chart that
13386
+ * does not separate it from `cpuMainPercent` shows "busy" where the truth is
13387
+ * "allocating too much".
13388
+ *
13389
+ * Concurrent GC is the dominant tenant of that pool but not the only one
13390
+ * (background compilation runs there too), so it is reported as
13391
+ * "GC / V8 helpers" rather than as pure collection time. `null` has the same
13392
+ * meaning as on `cpuMainPercent`.
13393
+ */
13394
+ cpuGcPercent: number().nullable(),
13395
+ /** Threads seen in the tick scan. `null` under the same conditions. */
13396
+ threadCount: number().nullable(),
13283
13397
  /** Wall-clock uptime (seconds). Parsed from `ps etime`. */
13284
- uptimeSec: number(),
13285
- /** True when ancestor walk reaches `ppid=1` (reparented to init/launchd). */
13286
- orphaned: boolean()
13287
- });
13288
- var KillProcessInputSchema = object({
13289
- pid: number(),
13290
- /** Force = SIGKILL. Default is SIGTERM. */
13291
- force: boolean().optional()
13292
- });
13293
- var KillProcessResultSchema = object({
13294
- success: boolean(),
13295
- reason: string().optional(),
13296
- signal: _enum(["SIGTERM", "SIGKILL"]).optional()
13398
+ uptimeSec: number()
13297
13399
  });
13298
13400
  var DumpHeapSnapshotInputSchema = object({
13299
13401
  /** The addon whose runner should dump a heap snapshot. */
@@ -13306,6 +13408,104 @@ var DumpHeapSnapshotResultSchema = object({
13306
13408
  pid: number().optional(),
13307
13409
  reason: string().optional()
13308
13410
  });
13411
+ /**
13412
+ * One point of one function's series.
13413
+ *
13414
+ * The unsuffixed fields are the bucket's **MAXIMUM**, and that choice is the
13415
+ * point of the whole surface. The two obvious reductions both lie: a mean per
13416
+ * bucket smears a spike away, and taking every Nth sample skips it outright.
13417
+ * Either would give us a tool built to find peaks that does not show peaks.
13418
+ * `...Min` carries the other end, `samples` says how many raw snapshots folded
13419
+ * into the bucket, and a mean stays derivable where it is wanted.
13420
+ *
13421
+ * An UNREDUCED point is a one-sample bucket: `samples === 1` and each `...Min`
13422
+ * equals its unsuffixed twin. Reduced and unreduced are the same shape, so a
13423
+ * caller cannot tell which it received — which is what "one reader" means.
13424
+ */
13425
+ var LoadPointSchema = object({
13426
+ /** Bucket START, or the snapshot's own timestamp when unreduced. */
13427
+ atMs: number(),
13428
+ /** Raw snapshots in this bucket. Never 0 — AN EMPTY BUCKET IS ABSENT. */
13429
+ samples: number().int(),
13430
+ /**
13431
+ * `null` = UNKNOWN and it PROPAGATES: a bucket is null unless every process
13432
+ * of every snapshot in it reported a thread split. A partial sum is a
13433
+ * smaller number that looks exactly as real as a complete one.
13434
+ */
13435
+ cpuMainPercent: number().nullable(),
13436
+ cpuMainPercentMin: number().nullable(),
13437
+ cpuGcPercent: number().nullable(),
13438
+ cpuGcPercentMin: number().nullable(),
13439
+ /** Lifetime-average CPU%, summed. Always known — and never a rate. */
13440
+ cpuLifetimePercent: number(),
13441
+ cpuLifetimePercentMin: number(),
13442
+ memoryRssBytes: number(),
13443
+ memoryRssBytesMin: number(),
13444
+ processCount: number().int(),
13445
+ processCountMin: number().int()
13446
+ });
13447
+ /** One function's series. `key` is an addonId, `__root__` or `__unattributed__`. */
13448
+ var LoadFunctionSeriesSchema = object({
13449
+ key: string(),
13450
+ kind: _enum([
13451
+ "addon",
13452
+ "root",
13453
+ "unattributed"
13454
+ ]),
13455
+ /** Oldest-first. A missing interval is MISSING — never zero-filled. */
13456
+ points: array(LoadPointSchema).readonly()
13457
+ });
13458
+ var NodeLoadSeriesSchema = object({
13459
+ nodeId: string(),
13460
+ /** One entry per function seen in the window, heaviest-first. */
13461
+ series: array(LoadFunctionSeriesSchema).readonly(),
13462
+ /**
13463
+ * Width of one returned bucket, in ms. Equals the sampling cadence when no
13464
+ * reduction was needed — so a caller can always say what one point covers
13465
+ * without having to know whether it was reduced.
13466
+ */
13467
+ bucketMs: number(),
13468
+ /** Raw snapshots that went into this answer, across both tiers. */
13469
+ retainedSamples: number(),
13470
+ /** Oldest snapshot represented, or `null` when nothing is retained. */
13471
+ oldestAtMs: number().nullable(),
13472
+ /** The fixed sampling cadence in force on the cluster, in ms. */
13473
+ cadenceMs: number(),
13474
+ /**
13475
+ * Did the DURABLE tier contribute? `false` means the answer is the hot ring
13476
+ * alone — an agent (which holds no table), or a store that refused.
13477
+ * Reported because "the last hour" and "the last six hours" are different
13478
+ * questions and an operator must not have to guess which was answered.
13479
+ */
13480
+ durable: boolean()
13481
+ });
13482
+ var GetLoadSeriesInputSchema = object({
13483
+ /**
13484
+ * The node whose series is wanted.
13485
+ *
13486
+ * NOT named `nodeId`: the generated cap router strips a top-level
13487
+ * `nodeId` from every method input and uses it to ROUTE the call to
13488
+ * that node's provider (`generated-cap-routers.ts`). A series target
13489
+ * called `nodeId` would silently become a routing pin and never reach
13490
+ * the provider. The hub holds every node it hears from, so the
13491
+ * ordinary call is unpinned — answered by the hub, for any node.
13492
+ */
13493
+ forNodeId: string(),
13494
+ /**
13495
+ * EXCLUSIVE lower bound. A caller passes the newest `atMs` it already
13496
+ * holds and receives only what it is missing, so seeding a live chart
13497
+ * from this method cannot double a point already drawn.
13498
+ */
13499
+ sinceMs: number().optional(),
13500
+ /**
13501
+ * Most points the caller wants PER FUNCTION. The window is reduced to fit,
13502
+ * preserving min and max per bucket.
13503
+ *
13504
+ * Absent means NO reduction — legitimate for a short window and a trap for a
13505
+ * long one, which is why a chart passes its own pixel width.
13506
+ */
13507
+ maxPoints: number().int().positive().optional()
13508
+ });
13309
13509
  var SystemMetricsSchema = object({
13310
13510
  cpuPercent: number(),
13311
13511
  memoryPercent: number(),
@@ -13316,10 +13516,7 @@ var SystemMetricsSchema = object({
13316
13516
  gpuPercent: number().optional(),
13317
13517
  gpuMemoryPercent: number().optional()
13318
13518
  });
13319
- method(_void(), SystemResourceSnapshotSchema), method(_void(), SystemResourceSnapshotSchema.nullable()), method(_void(), SystemMetricsSchema), method(object({ dirPath: string() }), DiskSpaceInfoSchema), method(_void(), MetricsGpuInfoSchema.nullable()), method(_void(), number().nullable()), method(object({ pids: array(number()) }), array(PidResourceStatsSchema)), method(_void(), array(AddonInstanceSchema).readonly()), method(object({ addonId: string() }), PidResourceStatsSchema.nullable()), method(_void(), array(NodeProcessSchema).readonly()), method(KillProcessInputSchema, KillProcessResultSchema, {
13320
- kind: "mutation",
13321
- auth: "admin"
13322
- }), method(DumpHeapSnapshotInputSchema, DumpHeapSnapshotResultSchema, {
13519
+ method(_void(), SystemResourceSnapshotSchema), method(_void(), SystemResourceSnapshotSchema.nullable()), method(_void(), SystemMetricsSchema), method(object({ dirPath: string() }), DiskSpaceInfoSchema), method(_void(), MetricsGpuInfoSchema.nullable()), method(_void(), number().nullable()), method(object({ pids: array(number()) }), array(PidResourceStatsSchema)), method(_void(), array(AddonInstanceSchema).readonly()), method(object({ addonId: string() }), PidResourceStatsSchema.nullable()), method(_void(), array(NodeProcessSchema).readonly()), method(GetLoadSeriesInputSchema, NodeLoadSeriesSchema), method(DumpHeapSnapshotInputSchema, DumpHeapSnapshotResultSchema, {
13323
13520
  kind: "mutation",
13324
13521
  auth: "admin"
13325
13522
  });
@@ -26682,6 +26879,15 @@ var LoggingSettingsPatchSchema = object({
26682
26879
  * authority over the whole hierarchy and answers for every layer, so the
26683
26880
  * layer selector needs a name the transport does not already own.
26684
26881
  */
26882
+ /**
26883
+ * One contribution, plus WHO reported it.
26884
+ *
26885
+ * The addon and node are added by the hub as it enumerates providers, never by
26886
+ * the contributor: an addon reporting its own identity could report somebody
26887
+ * else's, and the whole point of this surface is that no claim is made by
26888
+ * anyone but its owner.
26889
+ */
26890
+ var ReportedLoadContributionSchema = LoadContributionSchema.extend({ addonId: string() });
26685
26891
  var GetLoggingSettingsInputSchema = object({
26686
26892
  scopeNodeId: string().optional(),
26687
26893
  /**
@@ -26740,7 +26946,7 @@ method(_void(), FeatureManifestSchema), method(_void(), HealthStatusSchema), met
26740
26946
  }), method(_void(), SiteLocationStatusSchema, {
26741
26947
  kind: "mutation",
26742
26948
  auth: "admin"
26743
- }), method(_void(), RequestCensusStatusSchema, { auth: "admin" }), method(GetLoggingSettingsInputSchema, LoggingSettingsStateSchema, { auth: "admin" }), method(SetLoggingSettingsInputSchema, LoggingSettingsStateSchema, {
26949
+ }), method(_void(), RequestCensusStatusSchema, { auth: "admin" }), method(_void(), array(ReportedLoadContributionSchema).readonly(), { auth: "admin" }), method(GetLoggingSettingsInputSchema, LoggingSettingsStateSchema, { auth: "admin" }), method(SetLoggingSettingsInputSchema, LoggingSettingsStateSchema, {
26744
26950
  kind: "mutation",
26745
26951
  auth: "admin"
26746
26952
  });
@@ -28356,6 +28562,12 @@ Object.freeze({
28356
28562
  addonId: null,
28357
28563
  access: "create"
28358
28564
  },
28565
+ "dataStoreProvider.insertMany": {
28566
+ capName: "data-store-provider",
28567
+ capScope: "system",
28568
+ addonId: null,
28569
+ access: "create"
28570
+ },
28359
28571
  "dataStoreProvider.isEmpty": {
28360
28572
  capName: "data-store-provider",
28361
28573
  capScope: "system",
@@ -29670,6 +29882,12 @@ Object.freeze({
29670
29882
  addonId: null,
29671
29883
  access: "create"
29672
29884
  },
29885
+ "loadContribution.list": {
29886
+ capName: "load-contribution",
29887
+ capScope: "system",
29888
+ addonId: null,
29889
+ access: "view"
29890
+ },
29673
29891
  "localNetwork.downloadCa": {
29674
29892
  capName: "local-network",
29675
29893
  capScope: "system",
@@ -29970,17 +30188,17 @@ Object.freeze({
29970
30188
  addonId: null,
29971
30189
  access: "view"
29972
30190
  },
29973
- "metricsProvider.getProcessStats": {
30191
+ "metricsProvider.getLoadSeries": {
29974
30192
  capName: "metrics-provider",
29975
30193
  capScope: "system",
29976
30194
  addonId: null,
29977
30195
  access: "view"
29978
30196
  },
29979
- "metricsProvider.killProcess": {
30197
+ "metricsProvider.getProcessStats": {
29980
30198
  capName: "metrics-provider",
29981
30199
  capScope: "system",
29982
30200
  addonId: null,
29983
- access: "create"
30201
+ access: "view"
29984
30202
  },
29985
30203
  "metricsProvider.listAddonInstances": {
29986
30204
  capName: "metrics-provider",
@@ -31992,6 +32210,12 @@ Object.freeze({
31992
32210
  addonId: null,
31993
32211
  access: "create"
31994
32212
  },
32213
+ "settingsStore.insertMany": {
32214
+ capName: "settings-store",
32215
+ capScope: "system",
32216
+ addonId: null,
32217
+ access: "create"
32218
+ },
31995
32219
  "settingsStore.isEmpty": {
31996
32220
  capName: "settings-store",
31997
32221
  capScope: "system",
@@ -32604,6 +32828,12 @@ Object.freeze({
32604
32828
  addonId: null,
32605
32829
  access: "create"
32606
32830
  },
32831
+ "system.getLoadContributions": {
32832
+ capName: "system",
32833
+ capScope: "system",
32834
+ addonId: null,
32835
+ access: "view"
32836
+ },
32607
32837
  "system.getLoggingSettings": {
32608
32838
  capName: "system",
32609
32839
  capScope: "system",
@@ -2,7 +2,7 @@ Object.defineProperties(exports, {
2
2
  __esModule: { value: true },
3
3
  [Symbol.toStringTag]: { value: "Module" }
4
4
  });
5
- const require_shared = require("./shared-BkgFJ2q-.js");
5
+ const require_shared = require("./shared-CWzgutnW.js");
6
6
  let node_stream = require("node:stream");
7
7
  let webdav = require("webdav");
8
8
  //#region src/providers/webdav/webdav-config-schema.ts
@@ -1,4 +1,4 @@
1
- import { a as safeJoinRemotePath, c as BaseAddon, i as rearmIdleAbort, o as scheduleIdleAbort, r as getRequiredBasePath, s as storageProviderCapability, t as createSessionId } from "./shared-JInb-Tpq.mjs";
1
+ import { a as safeJoinRemotePath, c as BaseAddon, i as rearmIdleAbort, o as scheduleIdleAbort, r as getRequiredBasePath, s as storageProviderCapability, t as createSessionId } from "./shared-AzvwyoO3.mjs";
2
2
  import { PassThrough } from "node:stream";
3
3
  import { AuthType, createClient } from "webdav";
4
4
  //#region src/providers/webdav/webdav-config-schema.ts
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@camstack/addon-remote-storage",
3
- "version": "1.2.34",
3
+ "version": "1.2.36",
4
4
  "description": "Remote storage providers (SFTP, S3, WebDAV) — unifies remote backends behind the storage-provider cap",
5
5
  "keywords": [
6
6
  "camstack",