@inhuman.tools/plexus-expectations 0.1.0 → 0.2.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@inhuman.tools/plexus-expectations",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Work graph: WorkExpectation (PEW), Job + honoring executor.",
   "license": "MIT",
   "author": "Merkle Bonsai",
@@ -37,7 +37,7 @@
     "zod": "^4.4.3",
     "tslib": "2.8.1",
     "xstate": "5.32.5",
-    "@inhuman.tools/error-with-invariant": "^0.1.0"
+    "@inhuman.tools/error-with-invariant": "^0.2.0"
   },
   "devDependencies": {
     "@types/node": "^24.0.0",
@@ -48,8 +48,8 @@
     "yjs": "13.6.33",
     "mobx": "6.16.1",
     "@here.build/plexus": "^0.9.6",
-    "@-internal-/tsconfig": "0.0.0",
-    "@-internal-/eslint-configs": "0.0.0"
+    "@-internal-/eslint-configs": "0.0.0",
+    "@-internal-/tsconfig": "0.0.0"
   },
   "repository": {
     "type": "git",

package/dist/driver/PEWDriverConnection.d.ts

@@ -1,139 +0,0 @@
-import type { PlexusAwareness } from "@here.build/plexus";
-import type { ExpectationActor } from "./ExpectationActor.js";
-import { type Attention } from "../shared/attention.js";
-import type { AnyWorkExpectation, WorkExpectation } from "../shared/models/WorkExpectation.js";
-import type { ReadyState } from "../shared/types.js";
-/** Duck-typed — drivers may ship a different Zod major than this package. */
-export type ConfigurationSchema = {
-    safeParse(data: unknown): {
-        readonly success: true;
-        readonly data: unknown;
-    } | {
-        readonly success: false;
-        readonly error: {
-            readonly issues: ReadonlyArray<{
-                readonly message?: string;
-            }>;
-        };
-    };
-};
-/** Process-local. Secrets are never a Plexus field. */
-export type ConnectionSecretsView = {
-    readonly revision?: number;
-    get(field: string): unknown | undefined;
-    /** MCP env_* enumerates deposited fields. */
-    all?(): Readonly<Record<string, unknown>> | undefined;
-    /** Hosts that persist a refreshed session (reauth) implement this. */
-    replace?(secrets: Readonly<Record<string, string>>): void;
-};
-/** Module-graph duplication breaks instanceof; the elevation gate checks this brand too. */
-export declare const PEW_DRIVER_CONNECTION_BRAND = "@inhuman.tools/plexus-expectations:PEWDriverConnection@1";
-/** A connection construction the driver already knows will work. */
-export type DriverOffer = {
-    readonly name: string;
-    readonly description: string;
-    readonly live: boolean;
-    readonly adoptable: boolean;
-    readonly settings: Readonly<Record<string, unknown>>;
-};
-/**
- * Driver extras the orchestrator mirrors onto `spec.live`.
- * Core process facts live on `readyState` / `error` / `offers`.
- */
-export declare function extraLiveFromState(state: object): Record<string, unknown>;
-/**
- * The CLASS is the driver (one loaded module per driver name).
- * The INSTANCE is a live connection (one per connection id).
- *
- * CLAIM DOES NOT LIVE HERE. Which WorkExpectation classes this driver handles
- * lives on the advertised driver record (`can`): dynamically loaded code does
- * not get to declare its own authority.
- *
- * Live state is report only — no machinery branches on it. Instance bootstrap
- * truth is `bootstrapDone` / `bootstrapPending`. Drivers read {@link attention}
- * as the reduced token, never clientIds.
- *
- * YAML doors ({@link configurationSchema} / {@link secretsSchema}) parse
- * without `new`. Secrets stay a live view — the host may replace it (reauth).
- */
-export declare abstract class PEWDriverConnection<E extends AnyWorkExpectation = AnyWorkExpectation, C = Readonly<Record<string, unknown>>> implements AsyncDisposable {
-    readonly connectionId: string;
-    static readonly pewBrand: string;
-    /**
-     * YAML settings shape. Default is a passthrough record — subclasses replace
-     * this with a real object schema (transforms included). First issue message
-     * is what construct / parse throw.
-     */
-    static readonly configurationSchema: ConfigurationSchema;
-    static readonly configurationLabel: string;
-    static configurationError(message: string): string;
-    /** YAML settings door. Does not construct an instance. */
-    static parseConfiguration(settings?: unknown): unknown;
-    static readonly secretsSchema: ConfigurationSchema;
-    static secretsError(message: string): string;
-    /** YAML secrets door. Does not construct an instance. */
-    static parseSecrets(secrets?: unknown): unknown;
-    /** Shared on the prototype chain — own extras per subclass. */
-    static readonly state: Record<string, unknown>;
-    static readonly offers: readonly DriverOffer[];
-    /** Kernel-plane occupancy hub. Orchestrator assignment is own-per-class. */
-    static awareness: PlexusAwareness | undefined;
-    static driverName: string;
-    /**
-     * A getter, not `@computed` — MobX: the decorator's initializer pins to the
-     * declaring class, so subclasses would share one computed.
-     */
-    static get attention(): Attention;
-    accessor readyState: ReadyState;
-    accessor error: string;
-    /**
-     * MobX: shallow — extras (models, tools, account) are replaced wholesale.
-     * Override the accessor with a wider literal to add driver facts.
-     */
-    accessor state: Record<string, unknown>;
-    accessor awareness: PlexusAwareness | undefined;
-    get attention(): Attention;
-    constructor(connectionId: string, settings?: unknown, secrets?: ConnectionSecretsView | Readonly<Record<string, unknown>>);
-    readonly settings: C;
-    /** Live view. The host may replace it (reauth). */
-    secrets: ConnectionSecretsView;
-    /**
-     * Host binds the disk writer for this connection's settings bag.
-     * Parsed settings stay readonly; a driver that learns a value overrides this.
-     */
-    bindSettingsWriter(_write: (patch: Readonly<Record<string, unknown>>) => void): void;
-    abstract bootstrap(): Promise<void>;
-    bootstrapDone: boolean;
-    bootstrapPending: Promise<void> | null;
-    /** `resolve()` threw — the connection is broken, not the work. */
-    broken: boolean;
-    /** Concurrent callers share one promise. Async settlement is its own MobX action. */
-    ensureBootstrapStarted(): Promise<void>;
-    failReady(error: unknown): void;
-    protected abstract resolve(expectation: E): ExpectationActor<E>;
-    /** Nothing in PEW calls this; hosts or tests may. */
-    [Symbol.asyncDispose](): Promise<void>;
-    private readonly actors;
-    private readonly liveActors;
-    has(expectation: WorkExpectation): boolean;
-    resolveExpectation<T extends AnyWorkExpectation>(expectation: T): ExpectationActor<T>;
-    release(expectation: WorkExpectation): void;
-    /**
-     * Logout/drop aborts interned work. Not park. Subclasses abort `#inflight`.
-     */
-    abortOnDrop(reason: unknown): void;
-    /**
-     * Honor one demand.
-     * `resolve()` throwing is a broken connection, not a failed expectation.
-     */
-    handle(expectation: WorkExpectation): void;
-}
-/**
- * A concrete `PEWDriverConnection` subclass — constructable, not abstract.
- * `loadDriverModule` returns `unknown`; {@link isDriverConnectionClass} is the gate.
- */
-export type DriverConnectionClass = {
-    [K in keyof typeof PEWDriverConnection]: (typeof PEWDriverConnection)[K];
-} & (new (...args: ConstructorParameters<typeof PEWDriverConnection>) => PEWDriverConnection);
-export declare function isDriverConnectionClass(value: unknown): value is DriverConnectionClass;
-//# sourceMappingURL=PEWDriverConnection.d.ts.map

package/dist/driver/PEWDriverConnection.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"PEWDriverConnection.d.ts","sourceRoot":"","sources":["../../src/driver/PEWDriverConnection.ts"],"names":[],"mappings":"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"}

package/dist/driver/PEWDriverConnection.js

@@ -1,298 +0,0 @@
-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;
-};
-import { DefaultedWeakMap } from "@here.build/collections";
-import { action, computed, observable, toJS } from "mobx";
-import { pewConfigurationSchema, pewSecretsSchema } from "../schemas/connection.js";
-import { attentionOf } from "../shared/attention.js";
-const EMPTY_SECRETS = { get: () => undefined };
-/** Module-graph duplication breaks instanceof; the elevation gate checks this brand too. */
-// eslint-disable-next-line no-secrets/no-secrets -- package identity tag, not a secret
-export const PEW_DRIVER_CONNECTION_BRAND = "@inhuman.tools/plexus-expectations:PEWDriverConnection@1";
-/**
- * Driver extras the orchestrator mirrors onto `spec.live`.
- * Core process facts live on `readyState` / `error` / `offers`.
- */
-export function extraLiveFromState(state) {
-    const extra = {};
-    for (const [key, value] of Object.entries(state)) {
-        if (value === undefined)
-            continue;
-        extra[key] = toJS(value);
-    }
-    return extra;
-}
-/**
- * The CLASS is the driver (one loaded module per driver name).
- * The INSTANCE is a live connection (one per connection id).
- *
- * CLAIM DOES NOT LIVE HERE. Which WorkExpectation classes this driver handles
- * lives on the advertised driver record (`can`): dynamically loaded code does
- * not get to declare its own authority.
- *
- * Live state is report only — no machinery branches on it. Instance bootstrap
- * truth is `bootstrapDone` / `bootstrapPending`. Drivers read {@link attention}
- * as the reduced token, never clientIds.
- *
- * YAML doors ({@link configurationSchema} / {@link secretsSchema}) parse
- * without `new`. Secrets stay a live view — the host may replace it (reauth).
- */
-let PEWDriverConnection = (() => {
-    var _a, _b;
-    let _instanceExtraInitializers = [];
-    let _readyState_decorators;
-    let _readyState_initializers = [];
-    let _readyState_extraInitializers = [];
-    let _error_decorators;
-    let _error_initializers = [];
-    let _error_extraInitializers = [];
-    let _state_decorators;
-    let _state_initializers = [];
-    let _state_extraInitializers = [];
-    let _awareness_decorators;
-    let _awareness_initializers = [];
-    let _awareness_extraInitializers = [];
-    let _get_attention_decorators;
-    let _ensureBootstrapStarted_decorators;
-    let _failReady_decorators;
-    return class PEWDriverConnection {
-        static {
-            const _metadata = typeof Symbol === "function" && Symbol.metadata ? Object.create(null) : void 0;
-            __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, _state_decorators, { kind: "accessor", name: "state", static: false, private: false, access: { has: obj => "state" in obj, get: obj => obj.state, set: (obj, value) => { obj.state = value; } }, metadata: _metadata }, _state_initializers, _state_extraInitializers);
-            __esDecorate(this, null, _awareness_decorators, { kind: "accessor", name: "awareness", static: false, private: false, access: { has: obj => "awareness" in obj, get: obj => obj.awareness, set: (obj, value) => { obj.awareness = value; } }, metadata: _metadata }, _awareness_initializers, _awareness_extraInitializers);
-            __esDecorate(this, null, _get_attention_decorators, { kind: "getter", name: "attention", static: false, private: false, access: { has: obj => "attention" in obj, get: obj => obj.attention }, metadata: _metadata }, null, _instanceExtraInitializers);
-            __esDecorate(this, null, _ensureBootstrapStarted_decorators, { kind: "method", name: "ensureBootstrapStarted", static: false, private: false, access: { has: obj => "ensureBootstrapStarted" in obj, get: obj => obj.ensureBootstrapStarted }, metadata: _metadata }, null, _instanceExtraInitializers);
-            __esDecorate(this, null, _failReady_decorators, { kind: "method", name: "failReady", static: false, private: false, access: { has: obj => "failReady" in obj, get: obj => obj.failReady }, metadata: _metadata }, null, _instanceExtraInitializers);
-            if (_metadata) Object.defineProperty(this, Symbol.metadata, { enumerable: true, configurable: true, writable: true, value: _metadata });
-        }
-        connectionId = __runInitializers(this, _instanceExtraInitializers);
-        // ── driver side (the CLASS is the driver) ─────────────────────────────
-        static pewBrand = PEW_DRIVER_CONNECTION_BRAND;
-        /**
-         * YAML settings shape. Default is a passthrough record — subclasses replace
-         * this with a real object schema (transforms included). First issue message
-         * is what construct / parse throw.
-         */
-        static configurationSchema = pewConfigurationSchema;
-        static configurationLabel = "";
-        static configurationError(message) {
-            const label = this.configurationLabel.trim();
-            return label === "" ? `connection config invalid: ${message}` : `${label} connection config invalid: ${message}`;
-        }
-        /** YAML settings door. Does not construct an instance. */
-        static parseConfiguration(settings = {}) {
-            const result = this.configurationSchema.safeParse(settings ?? {});
-            if (result.success)
-                return result.data;
-            const message = result.error.issues[0]?.message ?? "invalid";
-            throw new Error(this.configurationError(message));
-        }
-        static secretsSchema = pewSecretsSchema;
-        static secretsError(message) {
-            const label = this.configurationLabel.trim();
-            return label === "" ? `connection secrets invalid: ${message}` : `${label} connection secrets invalid: ${message}`;
-        }
-        /** YAML secrets door. Does not construct an instance. */
-        static parseSecrets(secrets = {}) {
-            const result = this.secretsSchema.safeParse(secrets ?? {});
-            if (result.success)
-                return result.data;
-            const message = result.error.issues[0]?.message ?? "invalid";
-            throw new Error(this.secretsError(message));
-        }
-        /** Shared on the prototype chain — own extras per subclass. */
-        static state = {};
-        static offers = [];
-        /** Kernel-plane occupancy hub. Orchestrator assignment is own-per-class. */
-        static awareness;
-        static driverName = "";
-        /**
-         * A getter, not `@computed` — MobX: the decorator's initializer pins to the
-         * declaring class, so subclasses would share one computed.
-         */
-        static get attention() {
-            const hub = this.awareness;
-            const name = this.driverName;
-            if (hub === undefined || name === "")
-                return "none";
-            return attentionOf(hub, { kind: "driver", name });
-        }
-        #readyState_accessor_storage = __runInitializers(this, _readyState_initializers, null);
-        // ── connection side (the INSTANCE is the connection) ──────────────────
-        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; }
-        #state_accessor_storage = (__runInitializers(this, _error_extraInitializers), __runInitializers(this, _state_initializers, {}));
-        /**
-         * MobX: shallow — extras (models, tools, account) are replaced wholesale.
-         * Override the accessor with a wider literal to add driver facts.
-         */
-        get state() { return this.#state_accessor_storage; }
-        set state(value) { this.#state_accessor_storage = value; }
-        #awareness_accessor_storage = (__runInitializers(this, _state_extraInitializers), __runInitializers(this, _awareness_initializers, undefined));
-        get awareness() { return this.#awareness_accessor_storage; }
-        set awareness(value) { this.#awareness_accessor_storage = value; }
-        get attention() {
-            const hub = this.awareness;
-            if (hub === undefined)
-                return "none";
-            return attentionOf(hub, { kind: "connection", id: this.connectionId });
-        }
-        constructor(connectionId, settings = {}, secrets = EMPTY_SECRETS) {
-            this.connectionId = connectionId;
-            const cls = new.target;
-            this.settings = cls.parseConfiguration(settings);
-            const view = typeof secrets.get === "function"
-                ? secrets
-                : {
-                    get: (field) => secrets[field],
-                    all: () => secrets,
-                };
-            cls.parseSecrets(view.all?.() ?? {});
-            this.secrets = view;
-        }
-        settings = __runInitializers(this, _awareness_extraInitializers);
-        /** Live view. The host may replace it (reauth). */
-        secrets;
-        /**
-         * Host binds the disk writer for this connection's settings bag.
-         * Parsed settings stay readonly; a driver that learns a value overrides this.
-         */
-        bindSettingsWriter(_write) { }
-        bootstrapDone = false;
-        bootstrapPending = null;
-        /** `resolve()` threw — the connection is broken, not the work. */
-        broken = false;
-        /** Concurrent callers share one promise. Async settlement is its own MobX action. */
-        ensureBootstrapStarted() {
-            if (this.bootstrapDone)
-                return Promise.resolve();
-            if (this.bootstrapPending)
-                return this.bootstrapPending;
-            this.readyState = "bootstrapping";
-            this.error = "";
-            this.bootstrapPending = this.bootstrap().then(action(() => {
-                this.bootstrapDone = true;
-                this.readyState = "ready";
-                this.error = "";
-            }), action((error) => {
-                this.readyState = "failed";
-                this.error = error instanceof Error ? error.message : String(error);
-                throw error;
-            }));
-            return this.bootstrapPending;
-        }
-        failReady(error) {
-            this.broken = true;
-            this.readyState = "failed";
-            this.error = error instanceof Error ? error.message : String(error);
-        }
-        /** Nothing in PEW calls this; hosts or tests may. */
-        async [(_readyState_decorators = [observable], _error_decorators = [observable], _state_decorators = [(_a = observable).shallow.bind(_a)], _awareness_decorators = [(_b = observable).ref.bind(_b)], _get_attention_decorators = [computed], _ensureBootstrapStarted_decorators = [action], _failReady_decorators = [action], Symbol.asyncDispose)]() { }
-        actors = new DefaultedWeakMap((expectation) => {
-            const actor = this.resolve(expectation);
-            this.liveActors.add(actor);
-            return actor;
-        });
-        liveActors = new Set();
-        has(expectation) {
-            return this.actors.has(expectation);
-        }
-        resolveExpectation(expectation) {
-            return this.actors.get(expectation);
-        }
-        release(expectation) {
-            if (!this.actors.has(expectation))
-                return;
-            const actor = this.actors.get(expectation);
-            this.actors.delete(expectation);
-            this.liveActors.delete(actor);
-            actor.leave();
-        }
-        /**
-         * Logout/drop aborts interned work. Not park. Subclasses abort `#inflight`.
-         */
-        abortOnDrop(reason) {
-            for (const actor of this.liveActors)
-                actor.abort(reason);
-        }
-        /**
-         * Honor one demand.
-         * `resolve()` throwing is a broken connection, not a failed expectation.
-         */
-        handle(expectation) {
-            if (this.broken)
-                return;
-            if (expectation.isDone)
-                return;
-            if (this.has(expectation)) {
-                const existing = this.resolveExpectation(expectation);
-                if (!existing.started)
-                    existing.start();
-                return;
-            }
-            let actor;
-            try {
-                actor = this.resolveExpectation(expectation);
-            }
-            catch (error) {
-                this.failReady(error);
-                return;
-            }
-            // Awareness / host policy may have sealed the work while resolve() ran.
-            // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition -- resolve() can seal via spawn hooks
-            if (expectation.isDone) {
-                actor.leave();
-                return;
-            }
-            if (!actor.started) {
-                actor.start();
-            }
-        }
-    };
-})();
-export { PEWDriverConnection };
-export function isDriverConnectionClass(value) {
-    if (typeof value !== "function")
-        return false;
-    if (value.pewBrand === PEW_DRIVER_CONNECTION_BRAND)
-        return true;
-    return (typeof value.prototype === "object" &&
-        value.prototype instanceof PEWDriverConnection);
-}
-//# sourceMappingURL=PEWDriverConnection.js.map

package/dist/driver/PEWDriverConnection.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"PEWDriverConnection.js","sourceRoot":"","sources":["../../src/driver/PEWDriverConnection.ts"],"names":[],"mappings":"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","sourcesContent":["import { DefaultedWeakMap } from \"@here.build/collections\";\nimport type { PlexusAwareness } from \"@here.build/plexus\";\nimport { action, computed, observable, toJS } from \"mobx\";\n\nimport type { ExpectationActor } from \"./ExpectationActor.js\";\nimport { pewConfigurationSchema, pewSecretsSchema } from \"../schemas/connection.js\";\nimport { attentionOf, type Attention } from \"../shared/attention.js\";\nimport type { AnyWorkExpectation, WorkExpectation } from \"../shared/models/WorkExpectation.js\";\nimport type { ReadyState } from \"../shared/types.js\";\n\n/** Duck-typed — drivers may ship a different Zod major than this package. */\nexport type ConfigurationSchema = {\n  safeParse(\n    data: unknown,\n  ):\n    | { readonly success: true; readonly data: unknown }\n    | { readonly success: false; readonly error: { readonly issues: ReadonlyArray<{ readonly message?: string }> } };\n};\n\n/** Process-local. Secrets are never a Plexus field. */\nexport type ConnectionSecretsView = {\n  readonly revision?: number;\n  get(field: string): unknown | undefined;\n  /** MCP env_* enumerates deposited fields. */\n  all?(): Readonly<Record<string, unknown>> | undefined;\n  /** Hosts that persist a refreshed session (reauth) implement this. */\n  replace?(secrets: Readonly<Record<string, string>>): void;\n};\n\nconst EMPTY_SECRETS: ConnectionSecretsView = { get: () => undefined };\n\n/** Module-graph duplication breaks instanceof; the elevation gate checks this brand too. */\n// eslint-disable-next-line no-secrets/no-secrets -- package identity tag, not a secret\nexport const PEW_DRIVER_CONNECTION_BRAND = \"@inhuman.tools/plexus-expectations:PEWDriverConnection@1\";\n\n/** A connection construction the driver already knows will work. */\nexport type DriverOffer = {\n  readonly name: string;\n  readonly description: string;\n  readonly live: boolean;\n  readonly adoptable: boolean;\n  readonly settings: Readonly<Record<string, unknown>>;\n};\n\n/**\n * Driver extras the orchestrator mirrors onto `spec.live`.\n * Core process facts live on `readyState` / `error` / `offers`.\n */\nexport function extraLiveFromState(state: object): Record<string, unknown> {\n  const extra: Record<string, unknown> = {};\n  for (const [key, value] of Object.entries(state)) {\n    if (value === undefined) continue;\n    extra[key] = toJS(value);\n  }\n  return extra;\n}\n\n/**\n * The CLASS is the driver (one loaded module per driver name).\n * The INSTANCE is a live connection (one per connection id).\n *\n * CLAIM DOES NOT LIVE HERE. Which WorkExpectation classes this driver handles\n * lives on the advertised driver record (`can`): dynamically loaded code does\n * not get to declare its own authority.\n *\n * Live state is report only — no machinery branches on it. Instance bootstrap\n * truth is `bootstrapDone` / `bootstrapPending`. Drivers read {@link attention}\n * as the reduced token, never clientIds.\n *\n * YAML doors ({@link configurationSchema} / {@link secretsSchema}) parse\n * without `new`. Secrets stay a live view — the host may replace it (reauth).\n */\nexport abstract class PEWDriverConnection<\n  E extends AnyWorkExpectation = AnyWorkExpectation,\n  C = Readonly<Record<string, unknown>>,\n> implements AsyncDisposable {\n  // ── driver side (the CLASS is the driver) ─────────────────────────────\n  static readonly pewBrand: string = PEW_DRIVER_CONNECTION_BRAND;\n\n  /**\n   * YAML settings shape. Default is a passthrough record — subclasses replace\n   * this with a real object schema (transforms included). First issue message\n   * is what construct / parse throw.\n   */\n  static readonly configurationSchema: ConfigurationSchema = pewConfigurationSchema;\n\n  static readonly configurationLabel: string = \"\";\n\n  static configurationError(message: string): string {\n    const label = this.configurationLabel.trim();\n    return label === \"\" ? `connection config invalid: ${message}` : `${label} connection config invalid: ${message}`;\n  }\n\n  /** YAML settings door. Does not construct an instance. */\n  static parseConfiguration(settings: unknown = {}): unknown {\n    const result = this.configurationSchema.safeParse(settings ?? {});\n    if (result.success) return result.data;\n    const message = result.error.issues[0]?.message ?? \"invalid\";\n    throw new Error(this.configurationError(message));\n  }\n\n  static readonly secretsSchema: ConfigurationSchema = pewSecretsSchema;\n\n  static secretsError(message: string): string {\n    const label = this.configurationLabel.trim();\n    return label === \"\" ? `connection secrets invalid: ${message}` : `${label} connection secrets invalid: ${message}`;\n  }\n\n  /** YAML secrets door. Does not construct an instance. */\n  static parseSecrets(secrets: unknown = {}): unknown {\n    const result = this.secretsSchema.safeParse(secrets ?? {});\n    if (result.success) return result.data;\n    const message = result.error.issues[0]?.message ?? \"invalid\";\n    throw new Error(this.secretsError(message));\n  }\n\n  /** Shared on the prototype chain — own extras per subclass. */\n  static readonly state: Record<string, unknown> = {};\n  static readonly offers: readonly DriverOffer[] = [];\n\n  /** Kernel-plane occupancy hub. Orchestrator assignment is own-per-class. */\n  static awareness: PlexusAwareness | undefined;\n  static driverName = \"\";\n\n  /**\n   * A getter, not `@computed` — MobX: the decorator's initializer pins to the\n   * declaring class, so subclasses would share one computed.\n   */\n  static get attention(): Attention {\n    const hub = this.awareness;\n    const name = this.driverName;\n    if (hub === undefined || name === \"\") return \"none\";\n    return attentionOf(hub, { kind: \"driver\", name });\n  }\n\n  // ── connection side (the INSTANCE is the connection) ──────────────────\n  @observable accessor readyState: ReadyState = null;\n  @observable accessor error: string = \"\";\n  /**\n   * MobX: shallow — extras (models, tools, account) are replaced wholesale.\n   * Override the accessor with a wider literal to add driver facts.\n   */\n  @observable.shallow accessor state: Record<string, unknown> = {};\n\n  @observable.ref accessor awareness: PlexusAwareness | undefined = undefined;\n\n  @computed\n  get attention(): Attention {\n    const hub = this.awareness;\n    if (hub === undefined) return \"none\";\n    return attentionOf(hub, { kind: \"connection\", id: this.connectionId });\n  }\n\n  constructor(\n    public readonly connectionId: string,\n    settings: unknown = {},\n    secrets: ConnectionSecretsView | Readonly<Record<string, unknown>> = EMPTY_SECRETS,\n  ) {\n    const cls = new.target as typeof PEWDriverConnection;\n    this.settings = cls.parseConfiguration(settings) as C;\n    const view: ConnectionSecretsView =\n      typeof (secrets as ConnectionSecretsView).get === \"function\"\n        ? (secrets as ConnectionSecretsView)\n        : {\n            get: (field) => (secrets as Readonly<Record<string, unknown>>)[field],\n            all: () => secrets as Readonly<Record<string, unknown>>,\n          };\n    cls.parseSecrets(view.all?.() ?? {});\n    this.secrets = view;\n  }\n  readonly settings: C;\n  /** Live view. The host may replace it (reauth). */\n  secrets: ConnectionSecretsView;\n\n  /**\n   * Host binds the disk writer for this connection's settings bag.\n   * Parsed settings stay readonly; a driver that learns a value overrides this.\n   */\n  bindSettingsWriter(_write: (patch: Readonly<Record<string, unknown>>) => void): void {}\n\n  abstract bootstrap(): Promise<void>;\n\n  bootstrapDone = false;\n  bootstrapPending: Promise<void> | null = null;\n  /** `resolve()` threw — the connection is broken, not the work. */\n  broken = false;\n  /** Concurrent callers share one promise. Async settlement is its own MobX action. */\n  @action\n  ensureBootstrapStarted(): Promise<void> {\n    if (this.bootstrapDone) return Promise.resolve();\n    if (this.bootstrapPending) return this.bootstrapPending;\n    this.readyState = \"bootstrapping\";\n    this.error = \"\";\n    this.bootstrapPending = this.bootstrap().then(\n      action(() => {\n        this.bootstrapDone = true;\n        this.readyState = \"ready\";\n        this.error = \"\";\n      }),\n      action((error: unknown) => {\n        this.readyState = \"failed\";\n        this.error = error instanceof Error ? error.message : String(error);\n        throw error;\n      }),\n    );\n    return this.bootstrapPending;\n  }\n\n  @action\n  failReady(error: unknown): void {\n    this.broken = true;\n    this.readyState = \"failed\";\n    this.error = error instanceof Error ? error.message : String(error);\n  }\n\n  protected abstract resolve(expectation: E): ExpectationActor<E>;\n  /** Nothing in PEW calls this; hosts or tests may. */\n  async [Symbol.asyncDispose](): Promise<void> {}\n\n  private readonly actors = new DefaultedWeakMap<WorkExpectation, ExpectationActor<any>>((expectation: WorkExpectation): ExpectationActor<any> => {\n  const actor = this.resolve(expectation as E);\n  this.liveActors.add(actor);\n  return actor;\n});\n  private readonly liveActors = new Set<ExpectationActor<any>>();\n\n  has(expectation: WorkExpectation): boolean {\n    return this.actors.has(expectation);\n  }\n  resolveExpectation<T extends AnyWorkExpectation>(expectation: T): ExpectationActor<T> {\n    return this.actors.get(expectation);\n  }\n  release(expectation: WorkExpectation): void {\n    if (!this.actors.has(expectation)) return;\n    const actor = this.actors.get(expectation);\n    this.actors.delete(expectation);\n    this.liveActors.delete(actor);\n    actor.leave();\n  }\n\n  /**\n   * Logout/drop aborts interned work. Not park. Subclasses abort `#inflight`.\n   */\n  abortOnDrop(reason: unknown): void {\n    for (const actor of this.liveActors) actor.abort(reason);\n  }\n\n  /**\n   * Honor one demand.\n   * `resolve()` throwing is a broken connection, not a failed expectation.\n   */\n  handle(expectation: WorkExpectation): void {\n    if (this.broken) return;\n    if (expectation.isDone) return;\n    if (this.has(expectation)) {\n      const existing = this.resolveExpectation(expectation);\n      if (!existing.started) existing.start();\n      return;\n    }\n\n    let actor: ExpectationActor<any>;\n    try {\n      actor = this.resolveExpectation(expectation);\n    } catch (error) {\n      this.failReady(error);\n      return;\n    }\n\n    // Awareness / host policy may have sealed the work while resolve() ran.\n    // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition -- resolve() can seal via spawn hooks\n    if (expectation.isDone) {\n      actor.leave();\n      return;\n    }\n\n    if (!actor.started) {\n      actor.start();\n    }\n  }\n}\n\n/**\n * A concrete `PEWDriverConnection` subclass — constructable, not abstract.\n * `loadDriverModule` returns `unknown`; {@link isDriverConnectionClass} is the gate.\n */\nexport type DriverConnectionClass = {\n  [K in keyof typeof PEWDriverConnection]: (typeof PEWDriverConnection)[K];\n} & (new (...args: ConstructorParameters<typeof PEWDriverConnection>) => PEWDriverConnection);\n\nexport function isDriverConnectionClass(value: unknown): value is DriverConnectionClass {\n  if (typeof value !== \"function\") return false;\n  if ((value as { pewBrand?: unknown }).pewBrand === PEW_DRIVER_CONNECTION_BRAND) return true;\n  return (\n    typeof (value as { prototype?: unknown }).prototype === \"object\" &&\n    (value as { prototype: object }).prototype instanceof PEWDriverConnection\n  );\n}\n"]}

package/dist/error-with-invariant.d.ts

@@ -1,9 +0,0 @@
-/**
- * Error whose `static invariant` throws `new this(...ctorArgs)`.
- * Not on ErrorConstructor — a receiver with extra constructor args
- * (`(code, message)`) does not fight `(condition, message?)`.
- */
-export declare class ErrorWithInvariant extends Error {
-    static invariant<T extends new (...args: any) => ErrorWithInvariant>(this: T, condition: unknown, ...args: ConstructorParameters<T>): asserts condition;
-}
-//# sourceMappingURL=error-with-invariant.d.ts.map

package/dist/error-with-invariant.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"error-with-invariant.d.ts","sourceRoot":"","sources":["../src/error-with-invariant.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,qBAAa,kBAAmB,SAAQ,KAAK;IAC3C,MAAM,CAAC,SAAS,CAAC,CAAC,SAAS,KAAK,GAAG,IAAI,EAAE,GAAG,KAAK,kBAAkB,EACjE,IAAI,EAAE,CAAC,EACP,SAAS,EAAE,OAAO,EAClB,GAAG,IAAI,EAAE,qBAAqB,CAAC,CAAC,CAAC,GAChC,OAAO,CAAC,SAAS;CAGrB"}

package/dist/error-with-invariant.js

@@ -1,12 +0,0 @@
-/**
- * Error whose `static invariant` throws `new this(...ctorArgs)`.
- * Not on ErrorConstructor — a receiver with extra constructor args
- * (`(code, message)`) does not fight `(condition, message?)`.
- */
-export class ErrorWithInvariant extends Error {
-    static invariant(condition, ...args) {
-        if (!condition)
-            throw new this(...args);
-    }
-}
-//# sourceMappingURL=error-with-invariant.js.map

package/dist/error-with-invariant.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"error-with-invariant.js","sourceRoot":"","sources":["../src/error-with-invariant.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,OAAO,kBAAmB,SAAQ,KAAK;IAC3C,MAAM,CAAC,SAAS,CAEd,SAAkB,EAClB,GAAG,IAA8B;QAEjC,IAAI,CAAC,SAAS;YAAE,MAAM,IAAI,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC;IAC1C,CAAC;CACF","sourcesContent":["/**\n * Error whose `static invariant` throws `new this(...ctorArgs)`.\n * Not on ErrorConstructor — a receiver with extra constructor args\n * (`(code, message)`) does not fight `(condition, message?)`.\n */\nexport class ErrorWithInvariant extends Error {\n  static invariant<T extends new (...args: any) => ErrorWithInvariant>(\n    this: T,\n    condition: unknown,\n    ...args: ConstructorParameters<T>\n  ): asserts condition {\n    if (!condition) throw new this(...args);\n  }\n}\n"]}

package/dist/shared/attention.d.ts

@@ -1,27 +0,0 @@
-/**
- * Attention occupancy. Clients publish on kernel awareness; PEW reduces to
- * none | ambient | focused. Interned connections outlive a session wrap, so
- * occupancy is not session-plane. Drivers read the reduced token — never clientIds.
- */
-import { type PlexusAwareness } from "@here.build/plexus";
-import { ConnectionSpec } from "./models/ConnectionSpec.js";
-import { DriverSpec } from "./models/DriverSpec.js";
-export type Attention = "none" | "ambient" | "focused";
-export declare const ATTENTION_LANE = "attention";
-export declare const ATTENTION_FOCUS_LANE = "attentionFocus";
-export type AttentionRef = {
-    readonly kind: "driver";
-    readonly name: string;
-} | {
-    readonly kind: "connection";
-    readonly id: string;
-};
-export type AttentionSubject = DriverSpec | ConnectionSpec;
-export type AttentionSource = AttentionSubject | Iterable<AttentionSubject | null | undefined> | null | undefined;
-export declare function attentionRefFromSpec(spec: AttentionSubject): AttentionRef;
-export declare function collectAttentionRefs(source: AttentionSource): AttentionRef[];
-export declare function publishAttention(hub: PlexusAwareness, refs: readonly AttentionRef[]): void;
-export declare function publishAttentionFocus(hub: PlexusAwareness, ref: AttentionRef | null): void;
-/** Union of every client's occupancy. Focused wins over ambient. */
-export declare function attentionOf(hub: PlexusAwareness, target: AttentionRef): Attention;
-//# sourceMappingURL=attention.d.ts.map

package/dist/shared/attention.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"attention.d.ts","sourceRoot":"","sources":["../../src/shared/attention.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAkB,KAAK,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAE1E,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAC5D,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAEpD,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,SAAS,GAAG,SAAS,CAAC;AAEvD,eAAO,MAAM,cAAc,cAAc,CAAC;AAC1C,eAAO,MAAM,oBAAoB,mBAAmB,CAAC;AAErD,MAAM,MAAM,YAAY,GACpB;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAClD;IAAE,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;CAAE,CAAC;AAEzD,MAAM,MAAM,gBAAgB,GAAG,UAAU,GAAG,cAAc,CAAC;AAE3D,MAAM,MAAM,eAAe,GAAG,gBAAgB,GAAG,QAAQ,CAAC,gBAAgB,GAAG,IAAI,GAAG,SAAS,CAAC,GAAG,IAAI,GAAG,SAAS,CAAC;AAElH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,gBAAgB,GAAG,YAAY,CAGzE;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,eAAe,GAAG,YAAY,EAAE,CAc5E;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,eAAe,EAAE,IAAI,EAAE,SAAS,YAAY,EAAE,GAAG,IAAI,CAO1F;AAED,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,eAAe,EAAE,GAAG,EAAE,YAAY,GAAG,IAAI,GAAG,IAAI,CAO1F;AAED,oEAAoE;AACpE,wBAAgB,WAAW,CAAC,GAAG,EAAE,eAAe,EAAE,MAAM,EAAE,YAAY,GAAG,SAAS,CAYjF"}