@inhuman.tools/harness 0.0.0-stage → 0.1.0

package/dist/client.js

@@ -0,0 +1,235 @@
+import { randomUUID } from "node:crypto";
+import { realpath } from "node:fs/promises";
+import { attentionRefFromSpec, collectAttentionRefs, publishAttention, publishAttentionFocus, } from "@inhuman.tools/plexus-expectations";
+import { comparer, reaction } from "mobx";
+import { WebSocket } from "ws";
+import { WebsocketProvider } from "y-websocket";
+import * as Y from "yjs";
+import { projectDocGuid, ProjectPlexus } from "./daemon/project/ProjectPlexus.js";
+import { ensure } from "./ensure.js";
+import { KERNEL_DOC_GUID, KernelPlexus } from "./models/kernel/index.js";
+import { SessionPlexus } from "./models/session/index.js";
+import { daemonSocketPath } from "./paths.js";
+import { step } from "./step.js";
+import { jsonRpcResponse } from "./transport/jsonrpc.js";
+import { forwardPlexusAwareness } from "./transport/relay.js";
+export class Client {
+    kernelPath;
+    projectPath;
+    sessionId;
+    kernelPlexus;
+    projectPlexus;
+    sessionPlexus;
+    kernelProvider;
+    sessionProvider;
+    static start(kernelPath, projectPath) {
+        return Client.#attach(kernelPath, projectPath);
+    }
+    static connect(kernelPath, projectPath, sessionId) {
+        return Client.#attach(kernelPath, projectPath, sessionId);
+    }
+    static async #attach(kernelPath, projectPath, sessionId) {
+        step(`client ${sessionId === undefined ? "start" : "connect"} ${kernelPath}`);
+        await ensure(kernelPath);
+        const kernel = await realpath(kernelPath);
+        const project = await realpath(projectPath);
+        const socketPath = daemonSocketPath(kernel);
+        step(`client sock ${socketPath}`);
+        const providers = [];
+        try {
+            const session = sessionId ?? randomUUID();
+            const sessionPlexus = await Client.#open(socketPath, "session", { path: project, sessionId: session }, new Y.Doc({ guid: `harness:session:${session}` }), (doc) => SessionPlexus.connect(doc), providers);
+            const sessionProvider = providers.at(-1) ?? null;
+            const kernelPlexus = await Client.#open(socketPath, "kernel", {}, new Y.Doc({ guid: KERNEL_DOC_GUID }), (doc) => KernelPlexus.connect(doc), providers);
+            const kernelProvider = providers.at(-1) ?? null;
+            const projectPlexus = await Client.#open(socketPath, "project", { path: project }, new Y.Doc({ guid: projectDocGuid(project) }), (doc) => ProjectPlexus.connect(doc), providers);
+            const client = new Client(kernel, project, sessionPlexus.root.sessionId, kernelPlexus, projectPlexus, sessionPlexus, kernelProvider, sessionProvider);
+            client.#providers.push(...providers);
+            return client;
+        }
+        catch (error) {
+            for (const provider of providers) {
+                // Plexus.connect rewrites doc.clientID; y-websocket destroy encodes
+                // awareness under that id. An empty states map then reads `.clock` of
+                // undefined and swallows the original attach error.
+                provider.disconnectBc = () => undefined;
+                provider.destroy();
+            }
+            throw error;
+        }
+    }
+    // HTTPServer upgrades only after the host is ready. y-websocket starts the handshake.
+    static async #open(socketPath, room, params, doc, attach, providers) {
+        const provider = new WebsocketProvider(`ws+unix://${socketPath}:`, room, doc, {
+            // y-websocket types the polyfill as the DOM WebSocket; Node `ws` is the unix dial.
+            // @ts-expect-error
+            WebSocketPolyfill: WebSocket,
+            params,
+            disableBc: true,
+            shouldReconnect: () => false,
+        });
+        providers.push(provider);
+        // disableBc skips broadcast-channel subscribe; disconnect() still runs
+        // disconnectBc, which encodes awareness against an empty Map and throws
+        // `Cannot read properties of undefined (reading 'clock')`.
+        provider.disconnectBc = () => undefined;
+        step(`client sync ${room}`);
+        if (!provider.synced) {
+            await new Promise((resolve, reject) => {
+                const finish = (error) => {
+                    provider.off("sync", onSync);
+                    provider.off("connection-error", onError);
+                    provider.off("closed", onClosed);
+                    if (error === undefined)
+                        resolve();
+                    else
+                        reject(error);
+                };
+                const onSync = (state) => {
+                    if (state)
+                        finish();
+                };
+                const onError = () => finish(new Error("Client: websocket error"));
+                const onClosed = () => finish(new Error("Client: websocket closed before sync"));
+                provider.on("sync", onSync);
+                provider.on("connection-error", onError);
+                provider.on("closed", onClosed);
+            });
+        }
+        step(`client synced ${room}`);
+        const instance = attach(doc);
+        const hub = instance.awareness;
+        if (hub !== undefined) {
+            forwardPlexusAwareness(hub, (frame) => {
+                const ws = provider.ws;
+                if (ws != null && ws.readyState === ws.OPEN)
+                    ws.send(frame);
+            });
+        }
+        return instance;
+    }
+    #providers = [];
+    #rpcId = 0;
+    #rpc = new Map();
+    #attentionStop = null;
+    #attentionFocusStop = null;
+    constructor(kernelPath, projectPath, sessionId, kernelPlexus, projectPlexus, sessionPlexus, kernelProvider = null, sessionProvider = null) {
+        this.kernelPath = kernelPath;
+        this.projectPath = projectPath;
+        this.sessionId = sessionId;
+        this.kernelPlexus = kernelPlexus;
+        this.projectPlexus = projectPlexus;
+        this.sessionPlexus = sessionPlexus;
+        this.kernelProvider = kernelProvider;
+        this.sessionProvider = sessionProvider;
+        this.#bindRpc(sessionProvider);
+    }
+    get kernelRoot() {
+        return this.kernelPlexus.root;
+    }
+    get sessionRoot() {
+        return this.sessionPlexus.root;
+    }
+    /**
+     * Ambient looking: specs currently in a list. Tracked as a MobX computed —
+     * occupancy retracts when the getter stops returning them.
+     */
+    setComputedAttention(fn) {
+        this.#attentionStop?.();
+        this.#attentionStop = reaction(() => collectAttentionRefs(fn()), (refs) => publishAttention(this.sessionPlexus.awareness, refs), { equals: comparer.structural, fireImmediately: true });
+    }
+    /**
+     * Focused looking: the one-of-a-kind spec in the UI. Tracked as a MobX
+     * computed — occupancy retracts when the getter returns null.
+     */
+    setComputedAttentionFocus(fn) {
+        this.#attentionFocusStop?.();
+        this.#attentionFocusStop = reaction(() => {
+            const spec = fn();
+            return spec == null ? null : attentionRefFromSpec(spec);
+        }, (ref) => publishAttentionFocus(this.sessionPlexus.awareness, ref), { equals: comparer.structural, fireImmediately: true });
+    }
+    request(method, params = {}) {
+        const ws = this.sessionProvider?.ws;
+        if (ws === null || ws === undefined || ws.readyState !== ws.OPEN) {
+            return Promise.reject(new Error("client: session socket is not open"));
+        }
+        const id = (this.#rpcId += 1);
+        return new Promise((resolve, reject) => {
+            this.#rpc.set(id, { resolve, reject });
+            ws.send(JSON.stringify({ jsonrpc: "2.0", id, method, params }));
+        });
+    }
+    #bindRpc(provider) {
+        if (provider === null)
+            return;
+        let bound = null;
+        const listen = () => {
+            const ws = provider.ws;
+            if (ws == null || ws === bound)
+                return;
+            bound = ws;
+            ws.addEventListener("message", (event) => {
+                if (typeof event.data !== "string")
+                    return;
+                provider.wsLastMessageReceived = Date.now();
+                this.#onRpcText(event.data);
+            });
+            // y-websocket still owns onmessage; a string payload is `new Uint8Array(string)` → empty buffer.
+            const yjs = ws.onmessage;
+            if (yjs != null) {
+                ws.onmessage = (event) => {
+                    if (typeof event.data === "string")
+                        return;
+                    yjs.call(ws, event);
+                };
+            }
+        };
+        listen();
+        provider.on("status", (event) => {
+            if (event.status === "connected")
+                listen();
+        });
+    }
+    #onRpcText(text) {
+        let raw;
+        try {
+            raw = JSON.parse(text);
+        }
+        catch {
+            return;
+        }
+        const parsed = jsonRpcResponse.safeParse(raw);
+        if (!parsed.success || typeof parsed.data.id !== "number")
+            return;
+        const pending = this.#rpc.get(parsed.data.id);
+        if (pending === undefined)
+            return;
+        this.#rpc.delete(parsed.data.id);
+        if ("error" in parsed.data) {
+            pending.reject(new Error(parsed.data.error.message));
+            return;
+        }
+        pending.resolve(parsed.data.result);
+    }
+    async [Symbol.asyncDispose]() {
+        this.#attentionStop?.();
+        this.#attentionStop = null;
+        this.#attentionFocusStop?.();
+        this.#attentionFocusStop = null;
+        publishAttention(this.sessionPlexus.awareness, []);
+        publishAttentionFocus(this.sessionPlexus.awareness, null);
+        for (const pending of this.#rpc.values())
+            pending.reject(new Error("client disposed"));
+        this.#rpc.clear();
+        for (const provider of this.#providers.splice(0)) {
+            // Plexus.connect rewrites doc.clientID; y-websocket destroy encodes awareness under that id.
+            provider.disconnectBc = () => undefined;
+            provider.destroy();
+        }
+        this.kernelPlexus.destroy();
+        this.projectPlexus.destroy();
+        this.sessionPlexus.destroy();
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/connections/adapters.d.ts

@@ -0,0 +1,39 @@
+import { DriverSpec } from "@inhuman.tools/plexus-expectations";
+import type { ConnectionSecretsView, DriverConnectionClass, PEWDriver } from "@inhuman.tools/plexus-expectations/driver";
+import { type AdoptCallback, type DriverAdoptArgs, type DriverAdoptBags } from "./adopt.js";
+import { type CredentialsStore } from "./credentials.js";
+import { type InternKernel } from "./intern.js";
+import type { DriverRegistry } from "./registry.js";
+import type { ResolveOptions } from "./resolve.js";
+export type DriverInventory = {
+    readonly [name: string]: {
+        readonly importPath: string;
+    } | undefined;
+};
+export declare function applyRegistryToDrivers(registry: DriverRegistry, drivers: Record<string, DriverSpec | undefined>): void;
+export declare function loadExternalDriver(importPath: string, moduleRoot: string): Promise<unknown>;
+export declare function externalLoaderFor(moduleRoot: string): (importPath: string) => Promise<unknown>;
+export declare function allocateConnectionId(used: ReadonlySet<string>, name: string): string;
+/** `connect/adopt` driver-class door. */
+export declare function resolveAdoptClass(registry: DriverRegistry, driverName: string, inventory: DriverInventory, options?: ResolveOptions): Promise<DriverConnectionClass>;
+/** `connect/adopt` after the class is resolved. */
+export declare function adoptRegisteredDriver(registry: DriverRegistry, driverName: string, inventory: DriverInventory, args: DriverAdoptArgs, callback: AdoptCallback, options?: ResolveOptions): Promise<DriverAdoptBags>;
+/** Session `loadDriverModule`. */
+export declare function loadDriverModule(registry: DriverRegistry, driver: {
+    readonly name: string;
+    readonly importPath: string;
+}, options?: ResolveOptions): Promise<DriverConnectionClass>;
+/** `probeCompletionCatalog` intern-probe. Shares PEW intern with session ensure. */
+export declare function internForDiscovery(registry: DriverRegistry, kernel: InternKernel, owner: object, connectionId: string, options: {
+    readonly secrets: CredentialsStore | ConnectionSecretsView;
+    readonly awareness?: PEWDriver["awareness"];
+    readonly loadExternal?: ResolveOptions["loadExternal"];
+}): Promise<PEWDriver>;
+/** Session ensure over the same intern as discovery. */
+export declare function internForExecution(registry: DriverRegistry, kernel: InternKernel, owner: object, connectionId: string, options: {
+    readonly secrets: CredentialsStore | ConnectionSecretsView;
+    readonly awareness?: PEWDriver["awareness"];
+    readonly loadExternal?: ResolveOptions["loadExternal"];
+}): Promise<PEWDriver>;
+export declare function completionConnectionIds(connections: InternKernel["connections"], id?: string): string[];
+//# sourceMappingURL=adapters.d.ts.map

package/dist/connections/adapters.d.ts.map

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

package/dist/connections/adapters.js

@@ -0,0 +1,108 @@
+/**
+ * Adapters for connect/adopt, connect/models discovery, and session
+ * loadDriverModule. Vendors stay in the product roster. This file maps
+ * the Node import() door onto {@link DriverRegistry}.
+ */
+import { createRequire } from "node:module";
+import { join } from "node:path";
+import { pathToFileURL } from "node:url";
+import { applyDriverDefinition } from "@inhuman.tools/harness-provider-sdk";
+import { DriverSpec } from "@inhuman.tools/plexus-expectations";
+import { adoptDriver } from "./adopt.js";
+import { secretsView } from "./credentials.js";
+import { ensureRegisteredConnection } from "./intern.js";
+export function applyRegistryToDrivers(registry, drivers) {
+    for (const driver of registry.list()) {
+        const spec = drivers[driver.name] ?? new DriverSpec();
+        applyDriverDefinition(spec, driver);
+        drivers[driver.name] = spec;
+    }
+}
+export function loadExternalDriver(importPath, moduleRoot) {
+    const parent = join(moduleRoot, "package.json");
+    const url = pathToFileURL(createRequire(parent).resolve(importPath)).href;
+    return import(url).then((mod) => mod.default);
+}
+export function externalLoaderFor(moduleRoot) {
+    return (importPath) => loadExternalDriver(importPath, moduleRoot);
+}
+export function allocateConnectionId(used, name) {
+    const base = slug(name, "connection");
+    if (!used.has(base))
+        return base;
+    let n = 2;
+    while (used.has(`${base}-${n}`))
+        n += 1;
+    return `${base}-${n}`;
+}
+function slug(name, fallback) {
+    const s = name
+        .trim()
+        .toLowerCase()
+        .replaceAll(/[^a-z0-9]+/g, "-")
+        .replaceAll(/^-+|-+$/g, "");
+    return s.length > 0 ? s : fallback;
+}
+/** `connect/adopt` driver-class door. */
+export async function resolveAdoptClass(registry, driverName, inventory, options = {}) {
+    const spec = inventory[driverName];
+    if (spec === undefined || spec.importPath.trim() === "") {
+        throw new Error(`connect/adopt: unknown driver ${driverName}`);
+    }
+    return registry.resolve({ name: driverName, importPath: spec.importPath }, { ...options, purpose: "adopt" });
+}
+/** `connect/adopt` after the class is resolved. */
+export async function adoptRegisteredDriver(registry, driverName, inventory, args, callback, options = {}) {
+    const connectionClass = await resolveAdoptClass(registry, driverName, inventory, options);
+    return adoptDriver(connectionClass, args, callback);
+}
+/** Session `loadDriverModule`. */
+export async function loadDriverModule(registry, driver, options = {}) {
+    return registry.resolve(driver, { ...options, purpose: "execution" });
+}
+/** `probeCompletionCatalog` intern-probe. Shares PEW intern with session ensure. */
+export async function internForDiscovery(registry, kernel, owner, connectionId, options) {
+    const spec = kernel.connections[connectionId];
+    if (spec === undefined) {
+        throw new Error(`unknown connection ${connectionId}`);
+    }
+    return ensureRegisteredConnection(registry, kernel, owner, connectionId, {
+        purpose: "discovery",
+        secrets: isCredentialsStore(options.secrets) ? secretsView(options.secrets, connectionId) : options.secrets,
+        awareness: options.awareness,
+        loadExternal: options.loadExternal,
+    });
+}
+/** Session ensure over the same intern as discovery. */
+export async function internForExecution(registry, kernel, owner, connectionId, options) {
+    return ensureRegisteredConnection(registry, kernel, owner, connectionId, {
+        purpose: "execution",
+        secrets: isCredentialsStore(options.secrets) ? secretsView(options.secrets, connectionId) : options.secrets,
+        awareness: options.awareness,
+        loadExternal: options.loadExternal,
+    });
+}
+export function completionConnectionIds(connections, id) {
+    if (id != null) {
+        const spec = connections[id];
+        if (spec === undefined)
+            throw new Error(`unknown connection ${id}`);
+        if (!spec.driver.abilityClaim.includes("completion")) {
+            throw new Error(`${id} is not a completion connection`);
+        }
+        if (spec.configuration.enabled === false) {
+            throw new Error(`connection ${id} is disabled`);
+        }
+        return [id];
+    }
+    return Object.keys(connections)
+        .filter((key) => {
+        const spec = connections[key];
+        return spec != null && spec.driver.abilityClaim.includes("completion") && spec.configuration.enabled !== false;
+    })
+        .sort();
+}
+function isCredentialsStore(value) {
+    return typeof value.read === "function";
+}
+//# sourceMappingURL=adapters.js.map

package/dist/connections/adapters.js.map

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

package/dist/connections/adopt.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Host protocol: mint a persisted connection from a driver class.
+ *
+ * PEWDriver does not declare this. Drivers that need a conversation
+ * implement `static adopt`; {@link adoptDriver} passthroughs settings when
+ * the method is absent.
+ *
+ * `callback("UI", scheme)` parks on the kernel JSON-RPC host and resumes
+ * with the answer. Not an elicit protocol.
+ */
+export type AdoptCallback = (kind: "UI", body: string) => Promise<Readonly<Record<string, unknown>>>;
+export type DriverAdoptArgs = {
+    name?: string;
+    settings?: Record<string, unknown>;
+    /** The adopt request's abort: a client cancel while the driver waits on a browser. */
+    signal?: AbortSignal;
+    /** Secrets the caller already holds (`connect/adopt` with `secrets`): a driver does not ask for them again. */
+    secrets?: Readonly<Record<string, string>>;
+};
+export type DriverAdoptBags = {
+    readonly name?: string;
+    readonly settings: Record<string, unknown>;
+    readonly secrets: Record<string, string>;
+};
+export declare function adoptDriver(connectionClass: object, args: DriverAdoptArgs, callback: AdoptCallback): Promise<DriverAdoptBags>;
+//# sourceMappingURL=adopt.d.ts.map

package/dist/connections/adopt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adopt.d.ts","sourceRoot":"","sources":["../../src/connections/adopt.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,MAAM,MAAM,aAAa,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;AAErG,MAAM,MAAM,eAAe,GAAG;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,sFAAsF;IACtF,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,+GAA+G;IAC/G,OAAO,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CAC5C,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC3C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC1C,CAAC;AAIF,wBAAsB,WAAW,CAC/B,eAAe,EAAE,MAAM,EACvB,IAAI,EAAE,eAAe,EACrB,QAAQ,EAAE,aAAa,GACtB,OAAO,CAAC,eAAe,CAAC,CAI1B"}

package/dist/connections/adopt.js

@@ -0,0 +1,17 @@
+/**
+ * Host protocol: mint a persisted connection from a driver class.
+ *
+ * PEWDriver does not declare this. Drivers that need a conversation
+ * implement `static adopt`; {@link adoptDriver} passthroughs settings when
+ * the method is absent.
+ *
+ * `callback("UI", scheme)` parks on the kernel JSON-RPC host and resumes
+ * with the answer. Not an elicit protocol.
+ */
+export async function adoptDriver(connectionClass, args, callback) {
+    const adopt = connectionClass.adopt;
+    if (typeof adopt === "function")
+        return adopt.call(connectionClass, args, callback);
+    return { settings: { ...(args.settings ?? {}) }, secrets: {} };
+}
+//# sourceMappingURL=adopt.js.map

package/dist/connections/adopt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adopt.js","sourceRoot":"","sources":["../../src/connections/adopt.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAqBH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,eAAuB,EACvB,IAAqB,EACrB,QAAuB;IAEvB,MAAM,KAAK,GAAI,eAAuC,CAAC,KAAK,CAAC;IAC7D,IAAI,OAAO,KAAK,KAAK,UAAU;QAAE,OAAO,KAAK,CAAC,IAAI,CAAC,eAAe,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC;IACpF,OAAO,EAAE,QAAQ,EAAE,EAAE,GAAG,CAAC,IAAI,CAAC,QAAQ,IAAI,EAAE,CAAC,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;AACjE,CAAC"}

package/dist/connections/credentials.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Process-local credentials view. Durable storage stays with the runtime
+ * host; this package never keeps a second secrets table.
+ */
+import type { ConnectionSecretsView } from "@inhuman.tools/plexus-expectations/driver";
+export type ConnectionSecrets = Readonly<Record<string, string>>;
+export type CredentialsStore = {
+    read(connectionId: string): ConnectionSecrets;
+    write?(connectionId: string, secrets: ConnectionSecrets): void;
+};
+export declare function secretsView(store: CredentialsStore, connectionId: string): ConnectionSecretsView;
+export declare function memoryCredentialsStore(initial?: Record<string, Record<string, string>>): CredentialsStore;
+//# sourceMappingURL=credentials.d.ts.map

package/dist/connections/credentials.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"credentials.d.ts","sourceRoot":"","sources":["../../src/connections/credentials.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,2CAA2C,CAAC;AAEvF,MAAM,MAAM,iBAAiB,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;AAEjE,MAAM,MAAM,gBAAgB,GAAG;IAC7B,IAAI,CAAC,YAAY,EAAE,MAAM,GAAG,iBAAiB,CAAC;IAC9C,KAAK,CAAC,CAAC,YAAY,EAAE,MAAM,EAAE,OAAO,EAAE,iBAAiB,GAAG,IAAI,CAAC;CAChE,CAAC;AAEF,wBAAgB,WAAW,CAAC,KAAK,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,GAAG,qBAAqB,CAYhG;AAED,wBAAgB,sBAAsB,CAAC,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAM,GAAG,gBAAgB,CAe7G"}

package/dist/connections/credentials.js

@@ -0,0 +1,31 @@
+export function secretsView(store, connectionId) {
+    const write = store.write;
+    return {
+        get: (field) => store.read(connectionId)[field],
+        all: () => store.read(connectionId),
+        replace: write == null
+            ? undefined
+            : (secrets) => {
+                write(connectionId, { ...secrets });
+            },
+    };
+}
+export function memoryCredentialsStore(initial = {}) {
+    const bags = new Map();
+    for (const [id, secrets] of Object.entries(initial)) {
+        bags.set(id, { ...secrets });
+    }
+    return {
+        read(connectionId) {
+            return bags.get(connectionId) ?? {};
+        },
+        write(connectionId, secrets) {
+            const next = { ...secrets };
+            if (Object.keys(next).length === 0)
+                bags.delete(connectionId);
+            else
+                bags.set(connectionId, next);
+        },
+    };
+}
+//# sourceMappingURL=credentials.js.map

package/dist/connections/credentials.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"credentials.js","sourceRoot":"","sources":["../../src/connections/credentials.ts"],"names":[],"mappings":"AAaA,MAAM,UAAU,WAAW,CAAC,KAAuB,EAAE,YAAoB;IACvE,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC;IAC1B,OAAO;QACL,GAAG,EAAE,CAAC,KAAa,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,KAAK,CAAC;QACvD,GAAG,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC;QACnC,OAAO,EACL,KAAK,IAAI,IAAI;YACX,CAAC,CAAC,SAAS;YACX,CAAC,CAAC,CAAC,OAA0B,EAAE,EAAE;gBAC7B,KAAK,CAAC,YAAY,EAAE,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;YACtC,CAAC;KACR,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,UAAkD,EAAE;IACzF,MAAM,IAAI,GAAG,IAAI,GAAG,EAAkC,CAAC;IACvD,KAAK,MAAM,CAAC,EAAE,EAAE,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QACpD,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC/B,CAAC;IACD,OAAO;QACL,IAAI,CAAC,YAAoB;YACvB,OAAO,IAAI,CAAC,GAAG,CAAC,YAAY,CAAC,IAAI,EAAE,CAAC;QACtC,CAAC;QACD,KAAK,CAAC,YAAoB,EAAE,OAA0B;YACpD,MAAM,IAAI,GAAG,EAAE,GAAG,OAAO,EAAE,CAAC;YAC5B,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC;gBAAE,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;;gBACzD,IAAI,CAAC,GAAG,CAAC,YAAY,EAAE,IAAI,CAAC,CAAC;QACpC,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/connections/identity.d.ts

@@ -0,0 +1,5 @@
+/** Process-local brands. Not a PEW intern slot and not a vendor provider. */
+export declare const connectionsBrand: {
+    readonly registry: symbol;
+};
+//# sourceMappingURL=identity.d.ts.map

package/dist/connections/identity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity.d.ts","sourceRoot":"","sources":["../../src/connections/identity.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,eAAO,MAAM,gBAAgB;;CAEnB,CAAC"}

package/dist/connections/identity.js

@@ -0,0 +1,5 @@
+/** Process-local brands. Not a PEW intern slot and not a vendor provider. */
+export const connectionsBrand = {
+    registry: Symbol.for("@/connections:registry"),
+};
+//# sourceMappingURL=identity.js.map

package/dist/connections/identity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity.js","sourceRoot":"","sources":["../../src/connections/identity.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,QAAQ,EAAE,MAAM,CAAC,GAAG,CAAC,wBAAwB,CAAC;CACtC,CAAC"}

package/dist/connections/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * @/connections — registered driver resolver and
+ * PEW intern adapter for adopt, discovery, and execution.
+ *
+ * One intern table (PEW). No vendor providers, no plugin loader.
+ */
+export * from "./adopt.js";
+export * from "./adapters.js";
+export * from "./credentials.js";
+export * from "./identity.js";
+export * from "./intern.js";
+export * from "./registry.js";
+export { type DriverResolveSpec as DriverResolveSpec, type ExternalDriverLoader as ExternalDriverLoader, type ResolveOptions as ResolveOptions, type ResolvePurpose as ResolvePurpose, } from "./resolve.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/connections/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/connections/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,OAAO,EACL,KAAK,iBAAiB,IAAI,iBAAiB,EAC3C,KAAK,oBAAoB,IAAI,oBAAoB,EACjD,KAAK,cAAc,IAAI,cAAc,EACrC,KAAK,cAAc,IAAI,cAAc,GACtC,MAAM,cAAc,CAAC"}

package/dist/connections/index.js

@@ -0,0 +1,13 @@
+/**
+ * @/connections — registered driver resolver and
+ * PEW intern adapter for adopt, discovery, and execution.
+ *
+ * One intern table (PEW). No vendor providers, no plugin loader.
+ */
+export * from "./adopt.js";
+export * from "./adapters.js";
+export * from "./credentials.js";
+export * from "./identity.js";
+export * from "./intern.js";
+export * from "./registry.js";
+//# sourceMappingURL=index.js.map

package/dist/connections/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/connections/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC"}

package/dist/connections/intern.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Shared connection lifecycle over the existing PEW intern.
+ * Do not add a second process-local connection table here.
+ */
+import type { ConnectionSpec } from "@inhuman.tools/plexus-expectations";
+import type { ConnectionSecretsView, PEWDriver } from "@inhuman.tools/plexus-expectations/driver";
+import type { DriverRegistry } from "./registry.js";
+import type { ResolveOptions } from "./resolve.js";
+export type InternKernel = {
+    readonly connections: Record<string, ConnectionSpec | undefined>;
+};
+export type InternOptions = ResolveOptions & {
+    readonly secrets: ConnectionSecretsView;
+    readonly awareness?: PEWDriver["awareness"];
+};
+export declare function requireFreeConnectionId(kernel: InternKernel, id: string): void;
+export declare function ensureRegisteredConnection(registry: DriverRegistry, kernel: InternKernel, owner: object, connectionId: string, options: InternOptions): Promise<PEWDriver>;
+//# sourceMappingURL=intern.d.ts.map

package/dist/connections/intern.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"intern.d.ts","sourceRoot":"","sources":["../../src/connections/intern.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AACzE,OAAO,KAAK,EAAE,qBAAqB,EAAE,SAAS,EAAE,MAAM,2CAA2C,CAAC;AAIlG,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAEnD,MAAM,MAAM,YAAY,GAAG;IACzB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,GAAG,SAAS,CAAC,CAAC;CAClE,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG,cAAc,GAAG;IAC3C,QAAQ,CAAC,OAAO,EAAE,qBAAqB,CAAC;IACxC,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,CAAC,WAAW,CAAC,CAAC;CAC7C,CAAC;AAEF,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,YAAY,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI,CAI9E;AAED,wBAAsB,0BAA0B,CAC9C,QAAQ,EAAE,cAAc,EACxB,MAAM,EAAE,YAAY,EACpB,KAAK,EAAE,MAAM,EACb,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,SAAS,CAAC,CAcpB"}