@camstack/system 1.2.218 → 1.2.220

package/dist/builtins/native-metrics/proc-process-table.d.ts

@@ -0,0 +1,25 @@
+import { ProcReader } from '../../process/proc-stat.js';
+import { PsProcessRow } from './process-classification.js';
+/** Every process in `/proc`, as the rows `ps -eo …` would have printed. */
+export declare function readProcProcessTable(reader?: ProcReader): Promise<readonly PsProcessRow[]>;
+/**
+ * Parse `ps etime` → seconds. `MM:SS`, `HH:MM:SS`, `DD-HH:MM:SS`.
+ * Only the `ps` path needs this; `/proc` gives the number directly.
+ */
+export declare function parseEtime(etime: string): number;
+/** Parse the output of `ps -eo pid=,ppid=,pgid=,pcpu=,rss=,etime=,command=`. */
+export declare function parsePsTable(stdout: string): readonly PsProcessRow[];
+/** The fork. Only reached on a platform without `/proc`. */
+export declare function spawnPsTable(): Promise<readonly PsProcessRow[]>;
+/** What decides the source. Injectable so the choice is pinned by a test, not by the CI host. */
+export interface ProcessTableDeps {
+    readonly platform: NodeJS.Platform;
+    readonly reader: ProcReader;
+    readonly spawnPs: () => Promise<readonly PsProcessRow[]>;
+}
+/**
+ * The process table, from `/proc` where it exists and from `ps` elsewhere.
+ * Throws only when the chosen source cannot answer at all; the caller logs it
+ * as a skipped interval.
+ */
+export declare function readProcessTable(deps?: ProcessTableDeps): Promise<readonly PsProcessRow[]>;

package/dist/builtins/platform-probe/index.js

@@ -3,13 +3,13 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 const require_chunk = require("../../chunk-Cek0wNdY.js");
-const require_dist = require("../../dist-BOlMCOeT.js");
-let node_child_process = require("node:child_process");
-let node_util = require("node:util");
+const require_dist = require("../../dist-CllKpcTd.js");
 let node_fs = require("node:fs");
 node_fs = require_chunk.__toESM(node_fs);
+let node_child_process = require("node:child_process");
 let node_os = require("node:os");
 node_os = require_chunk.__toESM(node_os);
+let node_util = require("node:util");
 //#region src/builtins/platform-probe/coral-accelerators.ts
 /**
 * Coral USB Edge TPU USB identifiers.

package/dist/builtins/platform-probe/index.mjs

@@ -1,9 +1,9 @@
 import { o as __toESM } from "../../chunk-CNf5ZN-e.mjs";
-import { Et as platformProbeCapability, It as scoreRuntimes, Jt as errMsg, X as enumerateInferenceDevices, Yt as BaseAddon, un as emitReadiness, xn as EventCategory } from "../../dist-DigmGsQS.mjs";
-import { execFile } from "node:child_process";
-import { promisify } from "node:util";
+import { Et as platformProbeCapability, It as scoreRuntimes, Jt as errMsg, X as enumerateInferenceDevices, Yt as BaseAddon, un as emitReadiness, xn as EventCategory } from "../../dist-Ca_jaxXs.mjs";
 import * as fs from "node:fs";
+import { execFile } from "node:child_process";
 import * as os from "node:os";
+import { promisify } from "node:util";
 //#region src/builtins/platform-probe/coral-accelerators.ts
 /**
 * Coral USB Edge TPU USB identifiers.

package/dist/builtins/remote-access-orchestrator/remote-access-orchestrator.addon.js

@@ -3,7 +3,7 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 require("../../chunk-Cek0wNdY.js");
-const require_dist = require("../../dist-BOlMCOeT.js");
+const require_dist = require("../../dist-CllKpcTd.js");
 //#region src/builtins/remote-access-orchestrator/enabled-providers-reconcile.ts
 /**
 * Reconcile the durable `enabledProviders` set against authoritative

package/dist/builtins/remote-access-orchestrator/remote-access-orchestrator.addon.mjs

@@ -1,4 +1,4 @@
-import { Yt as BaseAddon, xn as EventCategory } from "../../dist-DigmGsQS.mjs";
+import { Yt as BaseAddon, xn as EventCategory } from "../../dist-Ca_jaxXs.mjs";
 //#region src/builtins/remote-access-orchestrator/enabled-providers-reconcile.ts
 /**
 * Reconcile the durable `enabledProviders` set against authoritative

package/dist/builtins/snapshot/index.js

@@ -3,7 +3,7 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 const require_chunk = require("../../chunk-Cek0wNdY.js");
-const require_dist = require("../../dist-BOlMCOeT.js");
+const require_dist = require("../../dist-CllKpcTd.js");
 let zod = require("zod");
 let node_crypto = require("node:crypto");
 let _camstack_types_node = require("@camstack/types/node");

package/dist/builtins/snapshot/index.mjs

@@ -1,4 +1,4 @@
-import { $t as DeviceFeature, F as bareAddonId, I as batteryCapability, Jt as errMsg, Rt as snapshotCapability, Ut as streamQualityLabel, W as deriveBatteryPresence, Yt as BaseAddon, i as BatteryStatusSchema, mn as nodePin, tn as DeviceType, xn as EventCategory } from "../../dist-DigmGsQS.mjs";
+import { $t as DeviceFeature, F as bareAddonId, I as batteryCapability, Jt as errMsg, Rt as snapshotCapability, Ut as streamQualityLabel, W as deriveBatteryPresence, Yt as BaseAddon, i as BatteryStatusSchema, mn as nodePin, tn as DeviceType, xn as EventCategory } from "../../dist-Ca_jaxXs.mjs";
 import { z } from "zod";
 import { randomUUID } from "node:crypto";
 import { signExpiringUrl, verifyExpiringUrl } from "@camstack/types/node";

package/dist/builtins/sqlite-storage/filesystem-storage.addon.js

@@ -3,7 +3,7 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 const require_chunk = require("../../chunk-Cek0wNdY.js");
-const require_dist = require("../../dist-BOlMCOeT.js");
+const require_dist = require("../../dist-CllKpcTd.js");
 let node_crypto = require("node:crypto");
 let node_fs_promises = require("node:fs/promises");
 let node_path = require("node:path");

package/dist/builtins/sqlite-storage/filesystem-storage.addon.mjs

@@ -1,4 +1,4 @@
-import { Ht as storageProviderCapability, Yt as BaseAddon, nt as filesystemBrowseCapability } from "../../dist-DigmGsQS.mjs";
+import { Ht as storageProviderCapability, Yt as BaseAddon, nt as filesystemBrowseCapability } from "../../dist-Ca_jaxXs.mjs";
 import { randomUUID } from "node:crypto";
 import { mkdir, readdir, realpath, statfs } from "node:fs/promises";
 import * as path$1 from "node:path";

package/dist/builtins/sqlite-storage/sqlite-pragmas.d.ts

@@ -95,6 +95,29 @@ export declare const SQLITE_JOURNAL_SIZE_LIMIT_BYTES = 67108864;
  * journal mode reports FULL and looks exactly like a regression in this file.
  */
 export declare const SQLITE_SYNCHRONOUS_IS_BUILD_DEFAULT = true;
+/**
+ * This connection's `wal_autocheckpoint`, in pages. 10 000 = **ten times the
+ * engine default**, ~40 MiB of WAL.
+ *
+ * The checkpoint is no longer this connection's job. Under `synchronous =
+ * NORMAL` the fsyncs of a WAL database happen at the checkpoint and nowhere
+ * else, and the engine's auto-checkpoint runs INSIDE the commit of whichever
+ * writer crosses its threshold — so on the hub every 1000 frames (12–25 s) a
+ * one-row `set` paid two fsyncs and a ~1000-page copy on the thread every
+ * configuration read in the cluster queues behind, and paid 1–10 s for it
+ * whenever the shared QLC drive was saturated (D449, measured in D452). The
+ * checkpoint now runs on a worker thread over its own connection at the SAME
+ * 1000-frame rule (`wal-checkpoint-policy.ts`), so the disk is asked for
+ * the same number of syncs by a thread nobody waits on.
+ *
+ * Why not `0` (auto-checkpoint off): a worker that dies would leave the WAL
+ * unbounded, and reads of a WAL page are `pread64`s the map never covers.
+ * Ten times the default is a bound the worker never lets it reach — it is
+ * the fallback, and `WalCheckpointer` logs an ERROR naming it the moment it
+ * becomes the only checkpoint. `__tests__/sqlite-pragmas.spec.ts` reads the
+ * value back.
+ */
+export declare const SQLITE_WAL_AUTOCHECKPOINT_BOUND_PAGES = 10000;
 /**
  * Hard ceiling on the map, in bytes. 2 GiB.
  *

package/dist/builtins/sqlite-storage/sqlite-settings-backend.d.ts

@@ -1,4 +1,4 @@
-import { BulkRecord, CollectionColumn, CollectionIndex, DataStoreEngineInfo, HistogramBucket, IScopedLogger, ISettingsBackend, QueryFilter, SettingsCountInput, SettingsDeleteInput, SettingsGetInput, SettingsAggregateInput, SettingsAggregateResult, SettingsHistogramInput, SettingsInsertInput, SettingsIsEmptyInput, SettingsQueryInput, SettingsRecord, SettingsSetInput, SettingsUpdateInput } from '@camstack/types';
+import { BulkRecord, CollectionColumn, CollectionIndex, DataStoreEngineInfo, HistogramBucket, IScopedLogger, ISettingsBackend, QueryFilter, SettingsAggregateInput, SettingsAggregateResult, SettingsCountInput, SettingsDeleteInput, SettingsGetInput, SettingsHistogramInput, SettingsInsertInput, SettingsIsEmptyInput, SettingsQueryInput, SettingsRecord, SettingsSetInput, SettingsUpdateInput } from '@camstack/types';
 import { default as Database } from 'better-sqlite3';
 import { MutationFilterInput } from './filter-compiler.js';
 import { SqliteOpProfiler } from './query-profiler.js';

package/dist/builtins/sqlite-storage/sqlite-settings.addon.d.ts

@@ -21,6 +21,7 @@ export declare class SqliteSettingsAddon extends BaseAddon {
     private backend;
     private vectorIndex;
     private walMaintenance;
+    private walCheckpointer;
     constructor();
     /**
      * The engine behind `settings-store` cannot read that door during

package/dist/builtins/sqlite-storage/wal-checkpoint-policy.d.ts

@@ -0,0 +1,115 @@
+/**
+ * When the checkpoint worker folds the WAL — the judgement, pure.
+ *
+ * ## Why a worker checkpoints at all
+ *
+ * `hub/sqlite-settings` is one JS thread with a synchronous binding, and every
+ * configuration read in the cluster queues behind whatever statement it is
+ * inside. With `journal_mode = WAL` and the build default `synchronous =
+ * NORMAL`, an ordinary commit is an append to the WAL with NO fsync. The
+ * fsyncs — the only thing in a one-row write that can take seconds — happen
+ * at the CHECKPOINT: the WAL is synced before the pages are copied, the
+ * database file after. And SQLite runs the auto-checkpoint (1000 pages)
+ * INSIDE the commit of whichever writer crosses the threshold.
+ *
+ * Measured on the hub, 2026-09-11 10:45–10:55 CEST, from outside the process
+ * (`/proc/<pid>/syscall` at 10 Hz + the wal-index header at 1 Hz, D452): the
+ * WAL refilled at ~54 frames/s, the auto-checkpoint fired every 12–25 s (42
+ * in 9.5 min), and every D-state run on the settings thread that sat in a
+ * syscall sat in `fsync` (74), each within ±2 s of a checkpoint event —
+ * 12.6 s of the 569 s window, all of it inside writers' commits. In the two
+ * saturated bursts earlier that morning (08:35–08:40, 09:30–09:39) the same
+ * fsync took 1–10 s, once per checkpoint, and the profiler filed each as a
+ * slow `set`. `synchronous` was never the lever: it was already NORMAL, and
+ * `sqlite-pragmas.ts` had said so since 2026-08-08.
+ *
+ * So the checkpoint runs on a worker thread, over its own connection. The
+ * settings thread's commits stay appends. What stays on the settings thread
+ * is the WAL-header sync SQLite performs when a WAL is reused after a
+ * completed checkpoint — one small fsync per cycle — and that residual is
+ * named here so nobody reads "no fsync on the settings thread" into this.
+ *
+ * ## The rule this file reproduces
+ *
+ * The auto-checkpoint's own rule: fold when 1000 frames are pending. The
+ * point of moving the checkpoint is to change WHO waits on the disk, not how
+ * often the disk is asked to sync — a worker that checkpointed every second
+ * would multiply the fsync count by ten on a drive the media plane already
+ * saturates. The threshold is read from the wal-index header (`mxFrame`,
+ * `nBackfill`), which costs a 136-byte read and no lock; when that read is
+ * unavailable the worker falls back to a fixed interval, so an unreadable
+ * header can never mean "nothing to do".
+ */
+/** The engine's own `wal_autocheckpoint` default, in frames. Reproduced, not changed. */
+export declare const WAL_CHECKPOINT_THRESHOLD_FRAMES = 1000;
+/**
+ * Longest the worker lets pending frames sit before folding them, in ms. A
+ * quiet database (a developer machine, an agent with little to persist) still
+ * gets its WAL folded and its pages made durable within a minute.
+ */
+export declare const WAL_CHECKPOINT_MAX_INTERVAL_MS = 60000;
+/** How often the worker looks at the wal-index, in ms. A 136-byte read. */
+export declare const WAL_CHECKPOINT_POLL_MS = 1000;
+/**
+ * A checkpoint that took this long is reported at WARN with its numbers.
+ * Matched to `SQLITE_SLOW_CALL_MS`: it is the same "the disk held us" event
+ * the profiler used to file as a slow `set`, now on the thread that paid it.
+ */
+export declare const WAL_CHECKPOINT_SLOW_MS = 1000;
+/** The two wal-index counters the judgement reads, or `null` when unreadable. */
+export interface WalIndexCounters {
+    /** Frames in the WAL that are valid for the current cycle. */
+    readonly mxFrame: number | null;
+    /** Frames already copied back into the database file. */
+    readonly nBackfill: number | null;
+}
+export interface CheckpointDecisionInput extends WalIndexCounters {
+    readonly sinceLastRunMs: number;
+}
+export type CheckpointReason = 'threshold' | 'interval' | 'unknown-interval' | 'below-threshold' | 'unknown-below-interval' | 'nothing-pending';
+export interface CheckpointDecision {
+    readonly run: boolean;
+    readonly reason: CheckpointReason;
+    readonly pendingFrames: number | null;
+}
+/** Should the worker run `wal_checkpoint(PASSIVE)` now? */
+export declare function decideCheckpoint(input: CheckpointDecisionInput): CheckpointDecision;
+/** Bytes needed to read both fields. */
+export declare const WAL_INDEX_HEADER_READ_BYTES: number;
+/**
+ * `mxFrame` and `nBackfill` from the first {@link WAL_INDEX_HEADER_READ_BYTES}
+ * of the `-shm` file, or `null` when the buffer is short or the two header
+ * copies disagree (a writer was updating them — SQLite's own readers retry on
+ * exactly that comparison; this caller simply waits for the next poll).
+ */
+export declare function parseWalIndexHeader(buffer: Buffer): WalIndexCounters | null;
+/** What the worker tells the parent after one checkpoint. */
+export interface CheckpointReport {
+    readonly kind: 'checkpointed';
+    readonly reason: CheckpointReason;
+    readonly pendingFrames: number | null;
+    /** `PRAGMA wal_checkpoint` row: frames in the WAL, frames now backfilled, busy flag. */
+    readonly walFrames: number;
+    readonly checkpointedFrames: number;
+    readonly busy: boolean;
+    readonly ms: number;
+}
+export interface WorkerReady {
+    readonly kind: 'ready';
+}
+export interface WorkerFailure {
+    readonly kind: 'failed';
+    readonly error: string;
+}
+export type WorkerMessage = CheckpointReport | WorkerReady | WorkerFailure;
+export interface WorkerStop {
+    readonly kind: 'stop';
+}
+/** What the worker is started with. */
+export interface WalCheckpointWorkerData {
+    readonly dbPath: string;
+    readonly pollMs: number;
+}
+/** Narrow a message off the worker port without a cast. */
+export declare function isWorkerMessage(value: unknown): value is WorkerMessage;
+export declare function isWorkerStop(value: unknown): value is WorkerStop;

package/dist/builtins/sqlite-storage/wal-checkpoint-worker.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/builtins/sqlite-storage/wal-checkpointer.d.ts

@@ -0,0 +1,70 @@
+import { IScopedLogger } from '@camstack/types';
+import { WalCheckpointWorkerData } from './wal-checkpoint-policy.js';
+/** How often the running totals are written as one INFO line, in ms. */
+export declare const WAL_CHECKPOINT_SUMMARY_INTERVAL_MS: number;
+/** Running totals since the last summary. Exposed for tests. */
+export interface WalCheckpointStats {
+    readonly checkpoints: number;
+    readonly frames: number;
+    readonly slow: number;
+    readonly maxMs: number;
+    readonly totalMs: number;
+    readonly busy: number;
+}
+/**
+ * The members of a `Worker` this class touches. Structural, so the unit spec
+ * drives an `EventEmitter` through the same surface without a cast.
+ */
+export interface CheckpointWorkerHandle {
+    on(event: 'message', listener: (message: unknown) => void): unknown;
+    on(event: 'error', listener: (err: unknown) => void): unknown;
+    on(event: 'exit', listener: (code: number) => void): unknown;
+    once(event: 'exit', listener: (code: number) => void): unknown;
+    postMessage(message: unknown): void;
+}
+/** The one impure step — spawning the thread — injectable for the unit spec. */
+export type WorkerFactory = (workerData: WalCheckpointWorkerData) => CheckpointWorkerHandle;
+/**
+ * Where the built worker entry lives: `dist/wal-checkpoint-worker.js` at the
+ * package root, next to `addon-runner.js`, found through the package's own
+ * `exports["./package.json"]` so it resolves the same way from the workspace
+ * and from an installed closure.
+ */
+export declare function defaultWorkerPath(): string;
+export interface WalCheckpointerOptions {
+    readonly dbPath: string;
+    readonly logger: IScopedLogger;
+    readonly pollMs?: number;
+    readonly slowMs?: number;
+    readonly summaryIntervalMs?: number;
+    /** Overrides the built entry — a spec points this at the TypeScript source. */
+    readonly workerPath?: string;
+    /** Extra `execArgv` for the thread — a spec passes a loader here. */
+    readonly workerExecArgv?: readonly string[];
+    readonly workerFactory?: WorkerFactory;
+}
+export declare class WalCheckpointer {
+    private readonly dbPath;
+    private readonly logger;
+    private readonly pollMs;
+    private readonly slowMs;
+    private readonly summaryIntervalMs;
+    private readonly spawn;
+    private worker;
+    private summaryTimer;
+    private stopping;
+    private statsValue;
+    constructor(options: WalCheckpointerOptions);
+    /** Totals since the last summary line. */
+    get stats(): WalCheckpointStats;
+    isRunning(): boolean;
+    start(): void;
+    /** Ask the thread to close its connection and exit; resolves when it has. */
+    stop(): Promise<void>;
+    /** One message off the port. Public so the spec can feed it directly. */
+    onMessage(message: unknown): void;
+    private handle;
+    private record;
+    private logSummary;
+    private onExit;
+}

package/dist/builtins/storage-orchestrator/storage-orchestrator.addon.js

@@ -3,7 +3,7 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 const require_chunk = require("../../chunk-Cek0wNdY.js");
-const require_dist = require("../../dist-BOlMCOeT.js");
+const require_dist = require("../../dist-CllKpcTd.js");
 const require_hub_cap_forward = require("../../hub-cap-forward-DmHNjbB0.js");
 let zod = require("zod");
 let node_crypto = require("node:crypto");

package/dist/builtins/storage-orchestrator/storage-orchestrator.addon.mjs

@@ -1,4 +1,4 @@
-import { Bt as storageMigrationCapability, D as StorageMigrationJobSchema, E as StorageLocationTypeSchema, Lt as settingsStoreCapability, R as collectSecretConfigKeys, St as modeMayWrite, T as StorageLocationModeSchema, Yt as BaseAddon, bt as mayWriteToLocation, et as evictionPolicyOfLocation, g as REDACTED_SECRET, hn as parseJsonObject, it as gbToBytes, jt as resolveLocationMode, m as LegacyStorageLocationDefaultSchema, pt as legacyModeOf, qt as withLocationMode, st as isLocationEnabled, w as StorageCleanupJobSchema, xn as EventCategory, yt as mayReadLocation, zt as storageCapability } from "../../dist-DigmGsQS.mjs";
+import { Bt as storageMigrationCapability, D as StorageMigrationJobSchema, E as StorageLocationTypeSchema, Lt as settingsStoreCapability, R as collectSecretConfigKeys, St as modeMayWrite, T as StorageLocationModeSchema, Yt as BaseAddon, bt as mayWriteToLocation, et as evictionPolicyOfLocation, g as REDACTED_SECRET, hn as parseJsonObject, it as gbToBytes, jt as resolveLocationMode, m as LegacyStorageLocationDefaultSchema, pt as legacyModeOf, qt as withLocationMode, st as isLocationEnabled, w as StorageCleanupJobSchema, xn as EventCategory, yt as mayReadLocation, zt as storageCapability } from "../../dist-Ca_jaxXs.mjs";
 import { t as HUB_CAP_FWD_ACTION } from "../../hub-cap-forward-BdT320dq.mjs";
 import { z } from "zod";
 import { randomUUID } from "node:crypto";

package/dist/builtins/system-config/system-config.addon.js

@@ -3,7 +3,7 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 require("../../chunk-Cek0wNdY.js");
-const require_dist = require("../../dist-BOlMCOeT.js");
+const require_dist = require("../../dist-CllKpcTd.js");
 //#region src/builtins/system-config/system-config.addon.ts
 /**
 * Built-in `system-config` addon — Phase 4 of the settings redesign.

package/dist/builtins/system-config/system-config.addon.mjs

@@ -1,4 +1,4 @@
-import { Jt as errMsg, Yt as BaseAddon, fn as hydrateSchema } from "../../dist-DigmGsQS.mjs";
+import { Jt as errMsg, Yt as BaseAddon, fn as hydrateSchema } from "../../dist-Ca_jaxXs.mjs";
 //#region src/builtins/system-config/system-config.addon.ts
 /**
 * Built-in `system-config` addon — Phase 4 of the settings redesign.

package/dist/builtins/winston-logging/index.js

@@ -3,7 +3,7 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 const require_chunk = require("../../chunk-Cek0wNdY.js");
-const require_dist = require("../../dist-BOlMCOeT.js");
+const require_dist = require("../../dist-CllKpcTd.js");
 const require_formatter = require("../../formatter-DqAKDlvN.js");
 let node_path = require("node:path");
 node_path = require_chunk.__toESM(node_path);

package/dist/builtins/winston-logging/index.mjs

@@ -1,4 +1,4 @@
-import { Yt as BaseAddon, gt as logDestinationCapability } from "../../dist-DigmGsQS.mjs";
+import { Yt as BaseAddon, gt as logDestinationCapability } from "../../dist-Ca_jaxXs.mjs";
 import { t as formatLogLine } from "../../formatter-B7qW8bPJ.mjs";
 import * as path$1 from "node:path";
 import path from "node:path";

package/dist/{custom-action-registry-BDwM5qAK.js → custom-action-registry-B42MC_Pv.js}

@@ -1,4 +1,4 @@
-const require_dist = require("./dist-BOlMCOeT.js");
+const require_dist = require("./dist-CllKpcTd.js");
 //#region src/kernel/custom-action-registry.ts
 /**
 * CustomActionRegistry — per-process registry of addon custom actions.

package/dist/{custom-action-registry-CsONUlhC.mjs → custom-action-registry-CpR58DXT.mjs}

@@ -1,4 +1,4 @@
-import { G as describeCustomActions } from "./dist-DigmGsQS.mjs";
+import { G as describeCustomActions } from "./dist-Ca_jaxXs.mjs";
 //#region src/kernel/custom-action-registry.ts
 /**
 * CustomActionRegistry — per-process registry of addon custom actions.