@inhuman.tools/plexus-expectations 0.0.0-stage → 0.1.0

package/dist/shared/models/ConnectionSpec.js

@@ -0,0 +1,180 @@
+var __runInitializers = (this && this.__runInitializers) || function (thisArg, initializers, value) {
+    var useValue = arguments.length > 2;
+    for (var i = 0; i < initializers.length; i++) {
+        value = useValue ? initializers[i].call(thisArg, value) : initializers[i].call(thisArg);
+    }
+    return useValue ? value : void 0;
+};
+var __esDecorate = (this && this.__esDecorate) || function (ctor, descriptorIn, decorators, contextIn, initializers, extraInitializers) {
+    function accept(f) { if (f !== void 0 && typeof f !== "function") throw new TypeError("Function expected"); return f; }
+    var kind = contextIn.kind, key = kind === "getter" ? "get" : kind === "setter" ? "set" : "value";
+    var target = !descriptorIn && ctor ? contextIn["static"] ? ctor : ctor.prototype : null;
+    var descriptor = descriptorIn || (target ? Object.getOwnPropertyDescriptor(target, contextIn.name) : {});
+    var _, done = false;
+    for (var i = decorators.length - 1; i >= 0; i--) {
+        var context = {};
+        for (var p in contextIn) context[p] = p === "access" ? {} : contextIn[p];
+        for (var p in contextIn.access) context.access[p] = contextIn.access[p];
+        context.addInitializer = function (f) { if (done) throw new TypeError("Cannot add initializers after decoration has completed"); extraInitializers.push(accept(f || null)); };
+        var result = (0, decorators[i])(kind === "accessor" ? { get: descriptor.get, set: descriptor.set } : descriptor[key], context);
+        if (kind === "accessor") {
+            if (result === void 0) continue;
+            if (result === null || typeof result !== "object") throw new TypeError("Object expected");
+            if (_ = accept(result.get)) descriptor.get = _;
+            if (_ = accept(result.set)) descriptor.set = _;
+            if (_ = accept(result.init)) initializers.unshift(_);
+        }
+        else if (_ = accept(result)) {
+            if (kind === "field") initializers.unshift(_);
+            else descriptor[key] = _;
+        }
+    }
+    if (target) Object.defineProperty(target, contextIn.name, descriptor);
+    done = true;
+};
+var __setFunctionName = (this && this.__setFunctionName) || function (f, name, prefix) {
+    if (typeof name === "symbol") name = name.description ? "[".concat(name.description, "]") : "";
+    return Object.defineProperty(f, "name", { configurable: true, value: prefix ? "".concat(prefix, " ", name) : name });
+};
+/**
+ * YAML connection inventory. Settings ride a private synced bag; the public
+ * face is {@link configuration} (deep-readonly get, whole-bag set).
+ * Secrets never live here. PEW process facts are `readyState` / `error`
+ * plus {@link live}. YAML file fill does not touch process facts.
+ */
+import { PlexusModel, syncing } from "@here.build/plexus";
+import { computed } from "mobx";
+import { readJsonRecord, writeJsonRecord } from "./jsonRecord.js";
+let ConnectionSpec = (() => {
+    var _a, _b, _c, _d, _e;
+    let _classDecorators = [syncing("@inhuman.tools/plexus-expectations:ConnectionSpec")];
+    let _classDescriptor;
+    let _classExtraInitializers = [];
+    let _classThis;
+    let _classSuper = PlexusModel;
+    let _instanceExtraInitializers = [];
+    let _driver_decorators;
+    let _driver_initializers = [];
+    let _driver_extraInitializers = [];
+    let _name_decorators;
+    let _name_initializers = [];
+    let _name_extraInitializers = [];
+    let _annotation_decorators;
+    let _annotation_initializers = [];
+    let _annotation_extraInitializers = [];
+    let _configurationMap_decorators;
+    let _configurationMap_initializers = [];
+    let _configurationMap_extraInitializers = [];
+    let _readyState_decorators;
+    let _readyState_initializers = [];
+    let _readyState_extraInitializers = [];
+    let _error_decorators;
+    let _error_initializers = [];
+    let _error_extraInitializers = [];
+    let _liveMap_decorators;
+    let _liveMap_initializers = [];
+    let _liveMap_extraInitializers = [];
+    let _get_configuration_decorators;
+    let _private_writeConfiguration_decorators;
+    let _private_writeConfiguration_descriptor;
+    let _get_live_decorators;
+    let _private_writeLive_decorators;
+    let _private_writeLive_descriptor;
+    let _stampProcess_decorators;
+    var ConnectionSpec = class extends _classSuper {
+        static { _classThis = this; }
+        static {
+            const _metadata = typeof Symbol === "function" && Symbol.metadata ? Object.create(_classSuper[Symbol.metadata] ?? null) : void 0;
+            _driver_decorators = [syncing];
+            _name_decorators = [syncing];
+            _annotation_decorators = [syncing];
+            _configurationMap_decorators = [(_a = syncing).record.bind(_a)];
+            _readyState_decorators = [syncing];
+            _error_decorators = [syncing];
+            _liveMap_decorators = [(_b = syncing).record.bind(_b)];
+            _get_configuration_decorators = [computed];
+            _private_writeConfiguration_decorators = [(_c = syncing).action.bind(_c)];
+            _get_live_decorators = [computed];
+            _private_writeLive_decorators = [(_d = syncing).action.bind(_d)];
+            _stampProcess_decorators = [(_e = syncing).action.bind(_e)];
+            __esDecorate(this, null, _driver_decorators, { kind: "accessor", name: "driver", static: false, private: false, access: { has: obj => "driver" in obj, get: obj => obj.driver, set: (obj, value) => { obj.driver = value; } }, metadata: _metadata }, _driver_initializers, _driver_extraInitializers);
+            __esDecorate(this, null, _name_decorators, { kind: "accessor", name: "name", static: false, private: false, access: { has: obj => "name" in obj, get: obj => obj.name, set: (obj, value) => { obj.name = value; } }, metadata: _metadata }, _name_initializers, _name_extraInitializers);
+            __esDecorate(this, null, _annotation_decorators, { kind: "accessor", name: "annotation", static: false, private: false, access: { has: obj => "annotation" in obj, get: obj => obj.annotation, set: (obj, value) => { obj.annotation = value; } }, metadata: _metadata }, _annotation_initializers, _annotation_extraInitializers);
+            __esDecorate(this, null, _configurationMap_decorators, { kind: "accessor", name: "configurationMap", static: false, private: false, access: { has: obj => "configurationMap" in obj, get: obj => obj.configurationMap, set: (obj, value) => { obj.configurationMap = value; } }, metadata: _metadata }, _configurationMap_initializers, _configurationMap_extraInitializers);
+            __esDecorate(this, null, _readyState_decorators, { kind: "accessor", name: "readyState", static: false, private: false, access: { has: obj => "readyState" in obj, get: obj => obj.readyState, set: (obj, value) => { obj.readyState = value; } }, metadata: _metadata }, _readyState_initializers, _readyState_extraInitializers);
+            __esDecorate(this, null, _error_decorators, { kind: "accessor", name: "error", static: false, private: false, access: { has: obj => "error" in obj, get: obj => obj.error, set: (obj, value) => { obj.error = value; } }, metadata: _metadata }, _error_initializers, _error_extraInitializers);
+            __esDecorate(this, null, _liveMap_decorators, { kind: "accessor", name: "liveMap", static: false, private: false, access: { has: obj => "liveMap" in obj, get: obj => obj.liveMap, set: (obj, value) => { obj.liveMap = value; } }, metadata: _metadata }, _liveMap_initializers, _liveMap_extraInitializers);
+            __esDecorate(this, null, _get_configuration_decorators, { kind: "getter", name: "configuration", static: false, private: false, access: { has: obj => "configuration" in obj, get: obj => obj.configuration }, metadata: _metadata }, null, _instanceExtraInitializers);
+            __esDecorate(this, _private_writeConfiguration_descriptor = { value: __setFunctionName(function (settings) {
+                    writeJsonRecord(this.configurationMap, settings);
+                }, "#writeConfiguration") }, _private_writeConfiguration_decorators, { kind: "method", name: "#writeConfiguration", static: false, private: true, access: { has: obj => #writeConfiguration in obj, get: obj => obj.#writeConfiguration }, metadata: _metadata }, null, _instanceExtraInitializers);
+            __esDecorate(this, null, _get_live_decorators, { kind: "getter", name: "live", static: false, private: false, access: { has: obj => "live" in obj, get: obj => obj.live }, metadata: _metadata }, null, _instanceExtraInitializers);
+            __esDecorate(this, _private_writeLive_descriptor = { value: __setFunctionName(function (next) {
+                    writeJsonRecord(this.liveMap, next);
+                }, "#writeLive") }, _private_writeLive_decorators, { kind: "method", name: "#writeLive", static: false, private: true, access: { has: obj => #writeLive in obj, get: obj => obj.#writeLive }, metadata: _metadata }, null, _instanceExtraInitializers);
+            __esDecorate(this, null, _stampProcess_decorators, { kind: "method", name: "stampProcess", static: false, private: false, access: { has: obj => "stampProcess" in obj, get: obj => obj.stampProcess }, metadata: _metadata }, null, _instanceExtraInitializers);
+            __esDecorate(null, _classDescriptor = { value: _classThis }, _classDecorators, { kind: "class", name: _classThis.name, metadata: _metadata }, null, _classExtraInitializers);
+            ConnectionSpec = _classThis = _classDescriptor.value;
+            if (_metadata) Object.defineProperty(_classThis, Symbol.metadata, { enumerable: true, configurable: true, writable: true, value: _metadata });
+            __runInitializers(_classThis, _classExtraInitializers);
+        }
+        get id() {
+            return this.parentFieldKey ?? "";
+        }
+        /** Only `failed` is a problem. */
+        get issue() {
+            return this.readyState === "failed" ? "failed" : false;
+        }
+        #driver_accessor_storage = (__runInitializers(this, _instanceExtraInitializers), __runInitializers(this, _driver_initializers, void 0));
+        /** YAML `driver:` resolves to this entity. */
+        get driver() { return this.#driver_accessor_storage; }
+        set driver(value) { this.#driver_accessor_storage = value; }
+        #name_accessor_storage = (__runInitializers(this, _driver_extraInitializers), __runInitializers(this, _name_initializers, ""));
+        get name() { return this.#name_accessor_storage; }
+        set name(value) { this.#name_accessor_storage = value; }
+        #annotation_accessor_storage = (__runInitializers(this, _name_extraInitializers), __runInitializers(this, _annotation_initializers, ""));
+        get annotation() { return this.#annotation_accessor_storage; }
+        set annotation(value) { this.#annotation_accessor_storage = value; }
+        #configurationMap_accessor_storage = (__runInitializers(this, _annotation_extraInitializers), __runInitializers(this, _configurationMap_initializers, {}));
+        get configurationMap() { return this.#configurationMap_accessor_storage; }
+        set configurationMap(value) { this.#configurationMap_accessor_storage = value; }
+        #readyState_accessor_storage = (__runInitializers(this, _configurationMap_extraInitializers), __runInitializers(this, _readyState_initializers, null));
+        /** PEW instance self-report. `null` = never ensured. YAML fill does not touch this. */
+        get readyState() { return this.#readyState_accessor_storage; }
+        set readyState(value) { this.#readyState_accessor_storage = value; }
+        #error_accessor_storage = (__runInitializers(this, _readyState_extraInitializers), __runInitializers(this, _error_initializers, ""));
+        get error() { return this.#error_accessor_storage; }
+        set error(value) { this.#error_accessor_storage = value; }
+        #liveMap_accessor_storage = (__runInitializers(this, _error_extraInitializers), __runInitializers(this, _liveMap_initializers, {}));
+        get liveMap() { return this.#liveMap_accessor_storage; }
+        set liveMap(value) { this.#liveMap_accessor_storage = value; }
+        /** Frozen through; assign the whole bag to write. */
+        get configuration() {
+            return readJsonRecord(this.configurationMap);
+        }
+        set configuration(settings) {
+            this.#writeConfiguration(settings);
+        }
+        get #writeConfiguration() { return _private_writeConfiguration_descriptor.value; }
+        get live() {
+            return readJsonRecord(this.liveMap);
+        }
+        set live(next) {
+            this.#writeLive(next);
+        }
+        get #writeLive() { return _private_writeLive_descriptor.value; }
+        /** Process self-report. YAML fill does not call this. */
+        stampProcess(next) {
+            this.readyState = next.readyState;
+            this.error = next.error;
+            this.live = next.live;
+        }
+        constructor() {
+            super(...arguments);
+            __runInitializers(this, _liveMap_extraInitializers);
+        }
+    };
+    return ConnectionSpec = _classThis;
+})();
+export { ConnectionSpec };
+//# sourceMappingURL=ConnectionSpec.js.map

package/dist/shared/models/ConnectionSpec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConnectionSpec.js","sourceRoot":"","sources":["../../../src/shared/models/ConnectionSpec.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * YAML connection inventory. Settings ride a private synced bag; the public\n * face is {@link configuration} (deep-readonly get, whole-bag set).\n * Secrets never live here. PEW process facts are `readyState` / `error`\n * plus {@link live}. YAML file fill does not touch process facts.\n */\nimport { PlexusModel, syncing } from \"@here.build/plexus\";\nimport { computed } from \"mobx\";\n\nimport type { ReadyState, SpecCatalog } from \"../types.js\";\nimport { DriverSpec } from \"./DriverSpec.js\";\nimport { readJsonRecord, writeJsonRecord, type LiveFacts } from \"./jsonRecord.js\";\n\nexport type ConfigurationAtom = string | number | boolean | null;\nexport type ConfigurationValue =\n  | ConfigurationAtom\n  | readonly ConfigurationValue[]\n  | { readonly [key: string]: ConfigurationValue };\nexport type ConnectionConfiguration = { readonly [key: string]: ConfigurationValue };\n\n@syncing(\"@inhuman.tools/plexus-expectations:ConnectionSpec\")\nexport class ConnectionSpec extends PlexusModel<SpecCatalog | null> {\n  get id(): string {\n    return (this.parentFieldKey as string | null) ?? \"\";\n  }\n\n  /** Only `failed` is a problem. */\n  get issue(): \"failed\" | false {\n    return this.readyState === \"failed\" ? \"failed\" : false;\n  }\n\n  /** YAML `driver:` resolves to this entity. */\n  @syncing accessor driver!: DriverSpec;\n  @syncing accessor name: string = \"\";\n  @syncing accessor annotation: string = \"\";\n  @syncing.record private accessor configurationMap: Record<string, string> = {};\n\n  /** PEW instance self-report. `null` = never ensured. YAML fill does not touch this. */\n  @syncing accessor readyState: ReadyState = null;\n  @syncing accessor error: string = \"\";\n  @syncing.record private accessor liveMap: Record<string, string> = {};\n\n  /** Frozen through; assign the whole bag to write. */\n  @computed\n  get configuration(): ConnectionConfiguration {\n    return readJsonRecord(this.configurationMap) as ConnectionConfiguration;\n  }\n\n  set configuration(settings: Readonly<Record<string, unknown>> | undefined) {\n    this.#writeConfiguration(settings);\n  }\n\n  @syncing.action\n  #writeConfiguration(settings: Readonly<Record<string, unknown>> | undefined): void {\n    writeJsonRecord(this.configurationMap, settings);\n  }\n\n  @computed\n  get live(): LiveFacts {\n    return readJsonRecord(this.liveMap) as LiveFacts;\n  }\n\n  set live(next: Readonly<Record<string, unknown>> | undefined) {\n    this.#writeLive(next);\n  }\n\n  @syncing.action\n  #writeLive(next: Readonly<Record<string, unknown>> | undefined): void {\n    writeJsonRecord(this.liveMap, next);\n  }\n\n  /** Process self-report. YAML fill does not call this. */\n  @syncing.action\n  stampProcess(next: {\n    readonly readyState: ReadyState;\n    readonly error: string;\n    readonly live: Readonly<Record<string, unknown>> | undefined;\n  }): void {\n    this.readyState = next.readyState;\n    this.error = next.error;\n    this.live = next.live;\n  }\n}\n\n"]}

package/dist/shared/models/DriverSpec.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Advertised driver inventory. `can` is a plexus list — file tokens, no load required.
+ * PEW process facts are `readyState` / `error` / `offersJson` plus {@link live}.
+ * YAML file fill does not touch process facts.
+ */
+import { PlexusModel } from "@here.build/plexus";
+import type { ReadyState, SpecCatalog } from "../types.js";
+import { type LiveFacts } from "./jsonRecord.js";
+/** How a new connection of this driver is offered, before the class loads. */
+export type DriverMultiplicity = "add-by-default" | "add-as-secondary";
+export declare class DriverSpec extends PlexusModel<SpecCatalog | null> {
+    #private;
+    accessor name: string;
+    accessor description: string;
+    accessor importPath: string;
+    /** Expectation kind names this driver handles. Not tool names. */
+    accessor abilityClaim: string[];
+    accessor multiplicity: DriverMultiplicity;
+    /** Module-load self-report. `null` = never loaded. YAML fill does not touch this. */
+    accessor readyState: ReadyState;
+    accessor error: string;
+    /** Offer list JSON. Null = no offers. */
+    private accessor offersJson;
+    private accessor liveMap;
+    get live(): LiveFacts;
+    set live(next: Readonly<Record<string, unknown>> | undefined);
+    /**
+     * Module-load self-report. Omitted `offersJson` / `live` stay
+     * (failure must not wipe a previous load).
+     */
+    stampLoad(next: {
+        readonly readyState: ReadyState;
+        readonly error: string;
+        readonly offersJson?: string | null;
+        readonly live?: Readonly<Record<string, unknown>>;
+    }): void;
+    /**
+     * Class-bootstrap offers. Null, blank, and the string `"null"` are no offers.
+     * A non-string cell or malformed JSON throws: a silent [] hides a driver defect.
+     */
+    get offers(): readonly object[];
+    set offers(next: readonly object[] | null);
+}
+export declare function readDriverOffers(raw: unknown): object[];
+//# sourceMappingURL=DriverSpec.d.ts.map

package/dist/shared/models/DriverSpec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DriverSpec.d.ts","sourceRoot":"","sources":["../../../src/shared/models/DriverSpec.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,WAAW,EAAW,MAAM,oBAAoB,CAAC;AAI1D,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC3D,OAAO,EAAmC,KAAK,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAElF,8EAA8E;AAC9E,MAAM,MAAM,kBAAkB,GAAG,gBAAgB,GAAG,kBAAkB,CAAC;AAEvE,qBACa,UAAW,SAAQ,WAAW,CAAC,WAAW,GAAG,IAAI,CAAC;;IACpD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAM;IAC3B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAM;IAClC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAM;IAC1C,kEAAkE;IACpD,QAAQ,CAAC,YAAY,EAAE,MAAM,EAAE,CAAM;IAC1C,QAAQ,CAAC,YAAY,EAAE,kBAAkB,CAAsB;IAExE,qFAAqF;IAC5E,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAQ;IACvC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAM;IACrC,yCAAyC;IAChC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAuB;IAC3C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA8B;IAEtE,IACI,IAAI,IAAI,SAAS,CAEpB;IAED,IAAI,IAAI,CAAC,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,SAAS,EAE3D;IAOD;;;OAGG;IAEH,SAAS,CAAC,IAAI,EAAE;QACd,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;QAChC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QACvB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QACpC,QAAQ,CAAC,IAAI,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;KACnD,GAAG,IAAI;IAOR;;;OAGG;IACH,IACI,MAAM,IAAI,SAAS,MAAM,EAAE,CAE9B;IAED,IAAI,MAAM,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI,EAExC;CAMF;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,EAAE,CAoBvD"}

package/dist/shared/models/DriverSpec.js

@@ -0,0 +1,221 @@
+var __runInitializers = (this && this.__runInitializers) || function (thisArg, initializers, value) {
+    var useValue = arguments.length > 2;
+    for (var i = 0; i < initializers.length; i++) {
+        value = useValue ? initializers[i].call(thisArg, value) : initializers[i].call(thisArg);
+    }
+    return useValue ? value : void 0;
+};
+var __esDecorate = (this && this.__esDecorate) || function (ctor, descriptorIn, decorators, contextIn, initializers, extraInitializers) {
+    function accept(f) { if (f !== void 0 && typeof f !== "function") throw new TypeError("Function expected"); return f; }
+    var kind = contextIn.kind, key = kind === "getter" ? "get" : kind === "setter" ? "set" : "value";
+    var target = !descriptorIn && ctor ? contextIn["static"] ? ctor : ctor.prototype : null;
+    var descriptor = descriptorIn || (target ? Object.getOwnPropertyDescriptor(target, contextIn.name) : {});
+    var _, done = false;
+    for (var i = decorators.length - 1; i >= 0; i--) {
+        var context = {};
+        for (var p in contextIn) context[p] = p === "access" ? {} : contextIn[p];
+        for (var p in contextIn.access) context.access[p] = contextIn.access[p];
+        context.addInitializer = function (f) { if (done) throw new TypeError("Cannot add initializers after decoration has completed"); extraInitializers.push(accept(f || null)); };
+        var result = (0, decorators[i])(kind === "accessor" ? { get: descriptor.get, set: descriptor.set } : descriptor[key], context);
+        if (kind === "accessor") {
+            if (result === void 0) continue;
+            if (result === null || typeof result !== "object") throw new TypeError("Object expected");
+            if (_ = accept(result.get)) descriptor.get = _;
+            if (_ = accept(result.set)) descriptor.set = _;
+            if (_ = accept(result.init)) initializers.unshift(_);
+        }
+        else if (_ = accept(result)) {
+            if (kind === "field") initializers.unshift(_);
+            else descriptor[key] = _;
+        }
+    }
+    if (target) Object.defineProperty(target, contextIn.name, descriptor);
+    done = true;
+};
+var __setFunctionName = (this && this.__setFunctionName) || function (f, name, prefix) {
+    if (typeof name === "symbol") name = name.description ? "[".concat(name.description, "]") : "";
+    return Object.defineProperty(f, "name", { configurable: true, value: prefix ? "".concat(prefix, " ", name) : name });
+};
+/**
+ * Advertised driver inventory. `can` is a plexus list — file tokens, no load required.
+ * PEW process facts are `readyState` / `error` / `offersJson` plus {@link live}.
+ * YAML file fill does not touch process facts.
+ */
+import { PlexusModel, syncing } from "@here.build/plexus";
+import { computed } from "mobx";
+import invariant from "tiny-invariant";
+import { readJsonRecord, writeJsonRecord } from "./jsonRecord.js";
+let DriverSpec = (() => {
+    var _a, _b, _c, _d, _e;
+    let _classDecorators = [syncing("@inhuman.tools/plexus-expectations:DriverSpec")];
+    let _classDescriptor;
+    let _classExtraInitializers = [];
+    let _classThis;
+    let _classSuper = PlexusModel;
+    let _instanceExtraInitializers = [];
+    let _name_decorators;
+    let _name_initializers = [];
+    let _name_extraInitializers = [];
+    let _description_decorators;
+    let _description_initializers = [];
+    let _description_extraInitializers = [];
+    let _importPath_decorators;
+    let _importPath_initializers = [];
+    let _importPath_extraInitializers = [];
+    let _abilityClaim_decorators;
+    let _abilityClaim_initializers = [];
+    let _abilityClaim_extraInitializers = [];
+    let _multiplicity_decorators;
+    let _multiplicity_initializers = [];
+    let _multiplicity_extraInitializers = [];
+    let _readyState_decorators;
+    let _readyState_initializers = [];
+    let _readyState_extraInitializers = [];
+    let _error_decorators;
+    let _error_initializers = [];
+    let _error_extraInitializers = [];
+    let _offersJson_decorators;
+    let _offersJson_initializers = [];
+    let _offersJson_extraInitializers = [];
+    let _liveMap_decorators;
+    let _liveMap_initializers = [];
+    let _liveMap_extraInitializers = [];
+    let _get_live_decorators;
+    let _private_writeLive_decorators;
+    let _private_writeLive_descriptor;
+    let _stampLoad_decorators;
+    let _get_offers_decorators;
+    let _private_writeOffers_decorators;
+    let _private_writeOffers_descriptor;
+    var DriverSpec = class extends _classSuper {
+        static { _classThis = this; }
+        static {
+            const _metadata = typeof Symbol === "function" && Symbol.metadata ? Object.create(_classSuper[Symbol.metadata] ?? null) : void 0;
+            _name_decorators = [syncing];
+            _description_decorators = [syncing];
+            _importPath_decorators = [syncing];
+            _abilityClaim_decorators = [(_a = syncing).list.bind(_a)];
+            _multiplicity_decorators = [syncing];
+            _readyState_decorators = [syncing];
+            _error_decorators = [syncing];
+            _offersJson_decorators = [syncing];
+            _liveMap_decorators = [(_b = syncing).record.bind(_b)];
+            _get_live_decorators = [computed];
+            _private_writeLive_decorators = [(_c = syncing).action.bind(_c)];
+            _stampLoad_decorators = [(_d = syncing).action.bind(_d)];
+            _get_offers_decorators = [computed];
+            _private_writeOffers_decorators = [(_e = syncing).action.bind(_e)];
+            __esDecorate(this, null, _name_decorators, { kind: "accessor", name: "name", static: false, private: false, access: { has: obj => "name" in obj, get: obj => obj.name, set: (obj, value) => { obj.name = value; } }, metadata: _metadata }, _name_initializers, _name_extraInitializers);
+            __esDecorate(this, null, _description_decorators, { kind: "accessor", name: "description", static: false, private: false, access: { has: obj => "description" in obj, get: obj => obj.description, set: (obj, value) => { obj.description = value; } }, metadata: _metadata }, _description_initializers, _description_extraInitializers);
+            __esDecorate(this, null, _importPath_decorators, { kind: "accessor", name: "importPath", static: false, private: false, access: { has: obj => "importPath" in obj, get: obj => obj.importPath, set: (obj, value) => { obj.importPath = value; } }, metadata: _metadata }, _importPath_initializers, _importPath_extraInitializers);
+            __esDecorate(this, null, _abilityClaim_decorators, { kind: "accessor", name: "abilityClaim", static: false, private: false, access: { has: obj => "abilityClaim" in obj, get: obj => obj.abilityClaim, set: (obj, value) => { obj.abilityClaim = value; } }, metadata: _metadata }, _abilityClaim_initializers, _abilityClaim_extraInitializers);
+            __esDecorate(this, null, _multiplicity_decorators, { kind: "accessor", name: "multiplicity", static: false, private: false, access: { has: obj => "multiplicity" in obj, get: obj => obj.multiplicity, set: (obj, value) => { obj.multiplicity = value; } }, metadata: _metadata }, _multiplicity_initializers, _multiplicity_extraInitializers);
+            __esDecorate(this, null, _readyState_decorators, { kind: "accessor", name: "readyState", static: false, private: false, access: { has: obj => "readyState" in obj, get: obj => obj.readyState, set: (obj, value) => { obj.readyState = value; } }, metadata: _metadata }, _readyState_initializers, _readyState_extraInitializers);
+            __esDecorate(this, null, _error_decorators, { kind: "accessor", name: "error", static: false, private: false, access: { has: obj => "error" in obj, get: obj => obj.error, set: (obj, value) => { obj.error = value; } }, metadata: _metadata }, _error_initializers, _error_extraInitializers);
+            __esDecorate(this, null, _offersJson_decorators, { kind: "accessor", name: "offersJson", static: false, private: false, access: { has: obj => "offersJson" in obj, get: obj => obj.offersJson, set: (obj, value) => { obj.offersJson = value; } }, metadata: _metadata }, _offersJson_initializers, _offersJson_extraInitializers);
+            __esDecorate(this, null, _liveMap_decorators, { kind: "accessor", name: "liveMap", static: false, private: false, access: { has: obj => "liveMap" in obj, get: obj => obj.liveMap, set: (obj, value) => { obj.liveMap = value; } }, metadata: _metadata }, _liveMap_initializers, _liveMap_extraInitializers);
+            __esDecorate(this, null, _get_live_decorators, { kind: "getter", name: "live", static: false, private: false, access: { has: obj => "live" in obj, get: obj => obj.live }, metadata: _metadata }, null, _instanceExtraInitializers);
+            __esDecorate(this, _private_writeLive_descriptor = { value: __setFunctionName(function (next) {
+                    writeJsonRecord(this.liveMap, next);
+                }, "#writeLive") }, _private_writeLive_decorators, { kind: "method", name: "#writeLive", static: false, private: true, access: { has: obj => #writeLive in obj, get: obj => obj.#writeLive }, metadata: _metadata }, null, _instanceExtraInitializers);
+            __esDecorate(this, null, _stampLoad_decorators, { kind: "method", name: "stampLoad", static: false, private: false, access: { has: obj => "stampLoad" in obj, get: obj => obj.stampLoad }, metadata: _metadata }, null, _instanceExtraInitializers);
+            __esDecorate(this, null, _get_offers_decorators, { kind: "getter", name: "offers", static: false, private: false, access: { has: obj => "offers" in obj, get: obj => obj.offers }, metadata: _metadata }, null, _instanceExtraInitializers);
+            __esDecorate(this, _private_writeOffers_descriptor = { value: __setFunctionName(function (next) {
+                    this.offersJson = next == null ? null : JSON.stringify(next);
+                }, "#writeOffers") }, _private_writeOffers_decorators, { kind: "method", name: "#writeOffers", static: false, private: true, access: { has: obj => #writeOffers in obj, get: obj => obj.#writeOffers }, metadata: _metadata }, null, _instanceExtraInitializers);
+            __esDecorate(null, _classDescriptor = { value: _classThis }, _classDecorators, { kind: "class", name: _classThis.name, metadata: _metadata }, null, _classExtraInitializers);
+            DriverSpec = _classThis = _classDescriptor.value;
+            if (_metadata) Object.defineProperty(_classThis, Symbol.metadata, { enumerable: true, configurable: true, writable: true, value: _metadata });
+            __runInitializers(_classThis, _classExtraInitializers);
+        }
+        #name_accessor_storage = (__runInitializers(this, _instanceExtraInitializers), __runInitializers(this, _name_initializers, ""));
+        get name() { return this.#name_accessor_storage; }
+        set name(value) { this.#name_accessor_storage = value; }
+        #description_accessor_storage = (__runInitializers(this, _name_extraInitializers), __runInitializers(this, _description_initializers, ""));
+        get description() { return this.#description_accessor_storage; }
+        set description(value) { this.#description_accessor_storage = value; }
+        #importPath_accessor_storage = (__runInitializers(this, _description_extraInitializers), __runInitializers(this, _importPath_initializers, ""));
+        get importPath() { return this.#importPath_accessor_storage; }
+        set importPath(value) { this.#importPath_accessor_storage = value; }
+        #abilityClaim_accessor_storage = (__runInitializers(this, _importPath_extraInitializers), __runInitializers(this, _abilityClaim_initializers, []));
+        /** Expectation kind names this driver handles. Not tool names. */
+        get abilityClaim() { return this.#abilityClaim_accessor_storage; }
+        set abilityClaim(value) { this.#abilityClaim_accessor_storage = value; }
+        #multiplicity_accessor_storage = (__runInitializers(this, _abilityClaim_extraInitializers), __runInitializers(this, _multiplicity_initializers, "add-as-secondary"));
+        get multiplicity() { return this.#multiplicity_accessor_storage; }
+        set multiplicity(value) { this.#multiplicity_accessor_storage = value; }
+        #readyState_accessor_storage = (__runInitializers(this, _multiplicity_extraInitializers), __runInitializers(this, _readyState_initializers, null));
+        /** Module-load self-report. `null` = never loaded. YAML fill does not touch this. */
+        get readyState() { return this.#readyState_accessor_storage; }
+        set readyState(value) { this.#readyState_accessor_storage = value; }
+        #error_accessor_storage = (__runInitializers(this, _readyState_extraInitializers), __runInitializers(this, _error_initializers, ""));
+        get error() { return this.#error_accessor_storage; }
+        set error(value) { this.#error_accessor_storage = value; }
+        #offersJson_accessor_storage = (__runInitializers(this, _error_extraInitializers), __runInitializers(this, _offersJson_initializers, null));
+        /** Offer list JSON. Null = no offers. */
+        get offersJson() { return this.#offersJson_accessor_storage; }
+        set offersJson(value) { this.#offersJson_accessor_storage = value; }
+        #liveMap_accessor_storage = (__runInitializers(this, _offersJson_extraInitializers), __runInitializers(this, _liveMap_initializers, {}));
+        get liveMap() { return this.#liveMap_accessor_storage; }
+        set liveMap(value) { this.#liveMap_accessor_storage = value; }
+        get live() {
+            return readJsonRecord(this.liveMap);
+        }
+        set live(next) {
+            this.#writeLive(next);
+        }
+        get #writeLive() { return _private_writeLive_descriptor.value; }
+        /**
+         * Module-load self-report. Omitted `offersJson` / `live` stay
+         * (failure must not wipe a previous load).
+         */
+        stampLoad(next) {
+            this.readyState = next.readyState;
+            this.error = next.error;
+            if (next.offersJson !== undefined)
+                this.offersJson = next.offersJson;
+            if (next.live !== undefined)
+                this.live = next.live;
+        }
+        /**
+         * Class-bootstrap offers. Null, blank, and the string `"null"` are no offers.
+         * A non-string cell or malformed JSON throws: a silent [] hides a driver defect.
+         */
+        get offers() {
+            return readDriverOffers(this.offersJson);
+        }
+        set offers(next) {
+            this.#writeOffers(next);
+        }
+        get #writeOffers() { return _private_writeOffers_descriptor.value; }
+        constructor() {
+            super(...arguments);
+            __runInitializers(this, _liveMap_extraInitializers);
+        }
+    };
+    return DriverSpec = _classThis;
+})();
+export { DriverSpec };
+export function readDriverOffers(raw) {
+    if (raw == null)
+        return [];
+    invariant(typeof raw === "string", "harness/kernel/offers: offersJson must be a JSON string");
+    const text = raw.trim();
+    if (text === "" || text === "null")
+        return [];
+    let parsed;
+    try {
+        parsed = JSON.parse(text);
+    }
+    catch (error) {
+        throw new Error(`harness/kernel/offers: offersJson is not valid JSON: ${error instanceof Error ? error.message : String(error)}`);
+    }
+    invariant(Array.isArray(parsed), "harness/kernel/offers: offersJson must be a JSON array of offer objects");
+    for (const item of parsed) {
+        invariant(typeof item === "object", "harness/kernel/offers: offersJson entries must be objects");
+        invariant(item !== null, "harness/kernel/offers: offersJson entries cannot be null");
+        invariant(!Array.isArray(item), "harness/kernel/offers: offersJson entries cannot be arrays");
+    }
+    return parsed;
+}
+//# sourceMappingURL=DriverSpec.js.map

package/dist/shared/models/DriverSpec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DriverSpec.js","sourceRoot":"","sources":["../../../src/shared/models/DriverSpec.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Advertised driver inventory. `can` is a plexus list — file tokens, no load required.\n * PEW process facts are `readyState` / `error` / `offersJson` plus {@link live}.\n * YAML file fill does not touch process facts.\n */\nimport { PlexusModel, syncing } from \"@here.build/plexus\";\nimport { computed } from \"mobx\";\nimport invariant from \"tiny-invariant\";\n\nimport type { ReadyState, SpecCatalog } from \"../types.js\";\nimport { readJsonRecord, writeJsonRecord, type LiveFacts } from \"./jsonRecord.js\";\n\n/** How a new connection of this driver is offered, before the class loads. */\nexport type DriverMultiplicity = \"add-by-default\" | \"add-as-secondary\";\n\n@syncing(\"@inhuman.tools/plexus-expectations:DriverSpec\")\nexport class DriverSpec extends PlexusModel<SpecCatalog | null> {\n  @syncing accessor name: string = \"\";\n  @syncing accessor description: string = \"\";\n  @syncing accessor importPath: string = \"\";\n  /** Expectation kind names this driver handles. Not tool names. */\n  @syncing.list accessor abilityClaim: string[] = [];\n  @syncing accessor multiplicity: DriverMultiplicity = \"add-as-secondary\";\n\n  /** Module-load self-report. `null` = never loaded. YAML fill does not touch this. */\n  @syncing accessor readyState: ReadyState = null;\n  @syncing accessor error: string = \"\";\n  /** Offer list JSON. Null = no offers. */\n  @syncing private accessor offersJson: string | null = null;\n  @syncing.record private accessor liveMap: Record<string, string> = {};\n\n  @computed\n  get live(): LiveFacts {\n    return readJsonRecord(this.liveMap) as LiveFacts;\n  }\n\n  set live(next: Readonly<Record<string, unknown>> | undefined) {\n    this.#writeLive(next);\n  }\n\n  @syncing.action\n  #writeLive(next: Readonly<Record<string, unknown>> | undefined): void {\n    writeJsonRecord(this.liveMap, next);\n  }\n\n  /**\n   * Module-load self-report. Omitted `offersJson` / `live` stay\n   * (failure must not wipe a previous load).\n   */\n  @syncing.action\n  stampLoad(next: {\n    readonly readyState: ReadyState;\n    readonly error: string;\n    readonly offersJson?: string | null;\n    readonly live?: Readonly<Record<string, unknown>>;\n  }): void {\n    this.readyState = next.readyState;\n    this.error = next.error;\n    if (next.offersJson !== undefined) this.offersJson = next.offersJson;\n    if (next.live !== undefined) this.live = next.live;\n  }\n\n  /**\n   * Class-bootstrap offers. Null, blank, and the string `\"null\"` are no offers.\n   * A non-string cell or malformed JSON throws: a silent [] hides a driver defect.\n   */\n  @computed\n  get offers(): readonly object[] {\n    return readDriverOffers(this.offersJson);\n  }\n\n  set offers(next: readonly object[] | null) {\n    this.#writeOffers(next);\n  }\n\n  @syncing.action\n  #writeOffers(next: readonly object[] | null): void {\n    this.offersJson = next == null ? null : JSON.stringify(next);\n  }\n}\n\nexport function readDriverOffers(raw: unknown): object[] {\n  if (raw == null) return [];\n  invariant(typeof raw === \"string\", \"harness/kernel/offers: offersJson must be a JSON string\");\n  const text = raw.trim();\n  if (text === \"\" || text === \"null\") return [];\n  let parsed: unknown;\n  try {\n    parsed = JSON.parse(text);\n  } catch (error) {\n    throw new Error(\n      `harness/kernel/offers: offersJson is not valid JSON: ${error instanceof Error ? error.message : String(error)}`,\n    );\n  }\n  invariant(Array.isArray(parsed), \"harness/kernel/offers: offersJson must be a JSON array of offer objects\");\n  for (const item of parsed) {\n    invariant(typeof item === \"object\", \"harness/kernel/offers: offersJson entries must be objects\");\n    invariant(item !== null, \"harness/kernel/offers: offersJson entries cannot be null\");\n    invariant(!Array.isArray(item), \"harness/kernel/offers: offersJson entries cannot be arrays\");\n  }\n  return parsed as object[];\n}\n"]}

package/dist/shared/models/IntrospectingPlexusModel.d.ts

@@ -0,0 +1,8 @@
+import { type Plexus, type PlexusAwareness, PlexusModel } from "@here.build/plexus";
+export type AwarenessOfPlexus<P extends Plexus<any, any>> = P extends Plexus<any, infer Awareness> ? Awareness : never;
+export declare abstract class IntrospectingPlexusModel<P extends Plexus<any, any> = Plexus<any, any>, Parent extends PlexusModel | null = any> extends PlexusModel<Parent> {
+    get plexus(): P | null;
+    get awareness(): PlexusAwareness<AwarenessOfPlexus<P>> | null;
+    getUniqueLanePresence<T extends string & keyof AwarenessOfPlexus<P>>(lane: T): AwarenessOfPlexus<P>[T] | null;
+}
+//# sourceMappingURL=IntrospectingPlexusModel.d.ts.map

package/dist/shared/models/IntrospectingPlexusModel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IntrospectingPlexusModel.d.ts","sourceRoot":"","sources":["../../../src/shared/models/IntrospectingPlexusModel.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,MAAM,EACX,KAAK,eAAe,EACpB,WAAW,EAEZ,MAAM,oBAAoB,CAAC;AAG5B,MAAM,MAAM,iBAAiB,CAAC,CAAC,SAAS,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,IAAI,CAAC,SAAS,MAAM,CAAC,GAAG,EAAE,MAAM,SAAS,CAAC,GAC9F,SAAS,GACT,KAAK,CAAC;AAEV,8BACsB,wBAAwB,CAC5C,CAAC,SAAS,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,EAC7C,MAAM,SAAS,WAAW,GAAG,IAAI,GAAG,GAAG,CACvC,SAAQ,WAAW,CAAC,MAAM,CAAC;IAC3B,IAAI,MAAM,IAAI,CAAC,GAAG,IAAI,CAOrB;IAED,IAAI,SAAS,IAAI,eAAe,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAE5D;IAED,qBAAqB,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,iBAAiB,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,GAAG,iBAAiB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAS5G;CACF"}

package/dist/shared/models/IntrospectingPlexusModel.js

@@ -0,0 +1,48 @@
+import { __esDecorate, __runInitializers } from "tslib";
+import { FieldAwareness, PlexusModel, syncing, } from "@here.build/plexus";
+import { docPlexus } from "@here.build/plexus/internals";
+let IntrospectingPlexusModel = (() => {
+    let _classDecorators = [syncing("@inhuman.tools/plexus-expectations:IntrospectingPlexusModel")];
+    let _classDescriptor;
+    let _classExtraInitializers = [];
+    let _classThis;
+    let _classSuper = PlexusModel;
+    var IntrospectingPlexusModel = class extends _classSuper {
+        static { _classThis = this; }
+        static {
+            const _metadata = typeof Symbol === "function" && Symbol.metadata ? Object.create(_classSuper[Symbol.metadata] ?? null) : void 0;
+            __esDecorate(null, _classDescriptor = { value: _classThis }, _classDecorators, { kind: "class", name: _classThis.name, metadata: _metadata }, null, _classExtraInitializers);
+            IntrospectingPlexusModel = _classThis = _classDescriptor.value;
+            if (_metadata) Object.defineProperty(_classThis, Symbol.metadata, { enumerable: true, configurable: true, writable: true, value: _metadata });
+            __runInitializers(_classThis, _classExtraInitializers);
+        }
+        get plexus() {
+            const doc = this.__doc__;
+            if (!doc)
+                return null;
+            const plexus = docPlexus.get(doc);
+            if (!plexus)
+                return null;
+            // docPlexus is untyped over root/awareness — narrow at the entity boundary.
+            return plexus;
+        }
+        get awareness() {
+            return this.plexus?.awareness ?? null;
+        }
+        getUniqueLanePresence(lane) {
+            const hub = this.awareness;
+            if (hub == null)
+                return null;
+            const field = new FieldAwareness(hub, lane);
+            for (const id of field.clientIds) {
+                const value = field.getOther(id);
+                if (value !== undefined)
+                    return value;
+            }
+            return null;
+        }
+    };
+    return IntrospectingPlexusModel = _classThis;
+})();
+export { IntrospectingPlexusModel };
+//# sourceMappingURL=IntrospectingPlexusModel.js.map

package/dist/shared/models/IntrospectingPlexusModel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IntrospectingPlexusModel.js","sourceRoot":"","sources":["../../../src/shared/models/IntrospectingPlexusModel.ts"],"names":[],"mappings":";AAAA,OAAO,EACL,cAAc,EAGd,WAAW,EACX,OAAO,GACR,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;IAOnC,wBAAwB;4BAD7C,OAAO,CAAC,6DAA6D,CAAC;;;;sBAI7D,WAAW;wCAAnB,SAAQ,WAAmB;;;;YAH7B,6KA2BC;;;YA3BqB,uDAAwB;;QAI5C,IAAI,MAAM;YACR,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC;YACzB,IAAI,CAAC,GAAG;gBAAE,OAAO,IAAI,CAAC;YACtB,MAAM,MAAM,GAAG,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YAClC,IAAI,CAAC,MAAM;gBAAE,OAAO,IAAI,CAAC;YACzB,4EAA4E;YAC5E,OAAO,MAAW,CAAC;QACrB,CAAC;QAED,IAAI,SAAS;YACX,OAAO,IAAI,CAAC,MAAM,EAAE,SAAS,IAAI,IAAI,CAAC;QACxC,CAAC;QAED,qBAAqB,CAAgD,IAAO;YAC1E,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC;YAC3B,IAAI,GAAG,IAAI,IAAI;gBAAE,OAAO,IAAI,CAAC;YAC7B,MAAM,KAAK,GAAG,IAAI,cAAc,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;YAC5C,KAAK,MAAM,EAAE,IAAI,KAAK,CAAC,SAAS,EAAE,CAAC;gBACjC,MAAM,KAAK,GAAG,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;gBACjC,IAAI,KAAK,KAAK,SAAS;oBAAE,OAAO,KAAK,CAAC;YACxC,CAAC;YACD,OAAO,IAAI,CAAC;QACd,CAAC;;;;SA1BmB,wBAAwB","sourcesContent":["import {\n  FieldAwareness,\n  type Plexus,\n  type PlexusAwareness,\n  PlexusModel,\n  syncing,\n} from \"@here.build/plexus\";\nimport { docPlexus } from \"@here.build/plexus/internals\";\n\nexport type AwarenessOfPlexus<P extends Plexus<any, any>> = P extends Plexus<any, infer Awareness>\n  ? Awareness\n  : never;\n\n@syncing(\"@inhuman.tools/plexus-expectations:IntrospectingPlexusModel\")\nexport abstract class IntrospectingPlexusModel<\n  P extends Plexus<any, any> = Plexus<any, any>,\n  Parent extends PlexusModel | null = any,\n> extends PlexusModel<Parent> {\n  get plexus(): P | null {\n    const doc = this.__doc__;\n    if (!doc) return null;\n    const plexus = docPlexus.get(doc);\n    if (!plexus) return null;\n    // docPlexus is untyped over root/awareness — narrow at the entity boundary.\n    return plexus as P;\n  }\n\n  get awareness(): PlexusAwareness<AwarenessOfPlexus<P>> | null {\n    return this.plexus?.awareness ?? null;\n  }\n\n  getUniqueLanePresence<T extends string & keyof AwarenessOfPlexus<P>>(lane: T): AwarenessOfPlexus<P>[T] | null {\n    const hub = this.awareness;\n    if (hub == null) return null;\n    const field = new FieldAwareness(hub, lane);\n    for (const id of field.clientIds) {\n      const value = field.getOther(id);\n      if (value !== undefined) return value;\n    }\n    return null;\n  }\n}\n"]}