@inhuman.tools/harness 0.0.0-stage → 0.2.0

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"}

package/dist/connections/intern.js

@@ -0,0 +1,30 @@
+import { acquireConnection } from "@inhuman.tools/plexus-expectations/executor";
+import { action } from "mobx";
+export function requireFreeConnectionId(kernel, id) {
+    if (kernel.connections[id] !== undefined) {
+        throw new Error(`connections: connection "${id}" collides`);
+    }
+}
+export async function ensureRegisteredConnection(registry, kernel, owner, connectionId, options) {
+    const spec = kernel.connections[connectionId];
+    if (spec === undefined) {
+        throw new Error(`connections: unknown connection ${connectionId}`);
+    }
+    const instance = await acquireConnection(kernel, owner, connectionId, async () => {
+        const connectionClass = await registry.resolve(spec.driver, options);
+        const minted = new connectionClass(connectionId, spec.configuration, options.secrets);
+        bindAwareness(minted, options.awareness);
+        return minted;
+    });
+    bindAwareness(instance, options.awareness);
+    await instance.ensureBootstrapStarted();
+    return instance;
+}
+function bindAwareness(instance, awareness) {
+    if (awareness === undefined)
+        return;
+    action(() => {
+        instance.awareness = awareness;
+    })();
+}
+//# sourceMappingURL=intern.js.map

package/dist/connections/intern.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"intern.js","sourceRoot":"","sources":["../../src/connections/intern.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,iBAAiB,EAAE,MAAM,6CAA6C,CAAC;AAChF,OAAO,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAc9B,MAAM,UAAU,uBAAuB,CAAC,MAAoB,EAAE,EAAU;IACtE,IAAI,MAAM,CAAC,WAAW,CAAC,EAAE,CAAC,KAAK,SAAS,EAAE,CAAC;QACzC,MAAM,IAAI,KAAK,CAAC,4BAA4B,EAAE,YAAY,CAAC,CAAC;IAC9D,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAC9C,QAAwB,EACxB,MAAoB,EACpB,KAAa,EACb,YAAoB,EACpB,OAAsB;IAEtB,MAAM,IAAI,GAAG,MAAM,CAAC,WAAW,CAAC,YAAY,CAAC,CAAC;IAC9C,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACvB,MAAM,IAAI,KAAK,CAAC,mCAAmC,YAAY,EAAE,CAAC,CAAC;IACrE,CAAC;IACD,MAAM,QAAQ,GAAG,MAAM,iBAAiB,CAAC,MAAM,EAAE,KAAK,EAAE,YAAY,EAAE,KAAK,IAAI,EAAE;QAC/E,MAAM,eAAe,GAAG,MAAM,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACrE,MAAM,MAAM,GAAG,IAAI,eAAe,CAAC,YAAY,EAAE,IAAI,CAAC,aAAa,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;QACtF,aAAa,CAAC,MAAM,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;QACzC,OAAO,MAAM,CAAC;IAChB,CAAC,CAAC,CAAC;IACH,aAAa,CAAC,QAAQ,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;IAC3C,MAAM,QAAQ,CAAC,sBAAsB,EAAE,CAAC;IACxC,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,SAAS,aAAa,CAAC,QAAmB,EAAE,SAAiC;IAC3E,IAAI,SAAS,KAAK,SAAS;QAAE,OAAO;IACpC,MAAM,CAAC,GAAG,EAAE;QACV,QAAQ,CAAC,SAAS,GAAG,SAAS,CAAC;IACjC,CAAC,CAAC,EAAE,CAAC;AACP,CAAC"}

package/dist/connections/registry.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Registered driver classes for adopt, discovery, and execution.
+ * Duplicate names fail here — before intern or bootstrap.
+ */
+import { type RegisteredDriver, type RegisteredProvider } from "@inhuman.tools/harness-provider-sdk";
+import type { DriverConnectionClass } from "@inhuman.tools/plexus-expectations/driver";
+import { connectionsBrand } from "./identity.js";
+import { type DriverResolveSpec, type ResolveOptions } from "./resolve.js";
+export declare class DriverRegistry {
+    #private;
+    readonly [connectionsBrand.registry]: true;
+    private constructor();
+    static fromDrivers(drivers: readonly RegisteredDriver[]): DriverRegistry;
+    get(name: string): RegisteredDriver | undefined;
+    require(name: string): RegisteredDriver;
+    list(): readonly RegisteredDriver[];
+    connectionClass(name: string): DriverConnectionClass;
+    resolve(spec: DriverResolveSpec, options?: ResolveOptions): Promise<DriverConnectionClass>;
+}
+export declare function openDriverRegistry(providers: readonly RegisteredProvider[]): DriverRegistry;
+export declare function isDriverRegistry(value: unknown): value is DriverRegistry;
+//# sourceMappingURL=registry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/connections/registry.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAkB,KAAK,gBAAgB,EAAE,KAAK,kBAAkB,EAAE,MAAM,qCAAqC,CAAC;AACrH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,2CAA2C,CAAC;AAEvF,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAIL,KAAK,iBAAiB,EACtB,KAAK,cAAc,EACpB,MAAM,cAAc,CAAC;AAEtB,qBAAa,cAAc;;aAChB,CAAC,gBAAgB,CAAC,QAAQ,CAAC;IAGpC,OAAO;IAYP,MAAM,CAAC,WAAW,CAAC,OAAO,EAAE,SAAS,gBAAgB,EAAE,GAAG,cAAc;IAIxE,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS;IAI/C,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB;IAQvC,IAAI,IAAI,SAAS,gBAAgB,EAAE;IAInC,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,qBAAqB;IAI9C,OAAO,CAAC,IAAI,EAAE,iBAAiB,EAAE,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,qBAAqB,CAAC;CAqBrG;AAED,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,SAAS,kBAAkB,EAAE,GAAG,cAAc,CAE3F;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,cAAc,CAMxE"}

package/dist/connections/registry.js

@@ -0,0 +1,69 @@
+/**
+ * Registered driver classes for adopt, discovery, and execution.
+ * Duplicate names fail here — before intern or bootstrap.
+ */
+import { flattenDrivers } from "@inhuman.tools/harness-provider-sdk";
+import { connectionsBrand } from "./identity.js";
+import { descriptorsMatch, incompatibleDescriptor, loadUnresolvedDriverClass, } from "./resolve.js";
+export class DriverRegistry {
+    [connectionsBrand.registry] = true;
+    #drivers;
+    constructor(drivers) {
+        const map = new Map();
+        for (const driver of drivers) {
+            const existing = map.get(driver.name);
+            if (existing !== undefined) {
+                throw new Error(`connections: driver "${driver.name}" collides`);
+            }
+            map.set(driver.name, driver);
+        }
+        this.#drivers = map;
+    }
+    static fromDrivers(drivers) {
+        return new DriverRegistry(drivers);
+    }
+    get(name) {
+        return this.#drivers.get(name);
+    }
+    require(name) {
+        const driver = this.#drivers.get(name);
+        if (driver === undefined) {
+            throw new Error(`connections: unknown driver ${name}`);
+        }
+        return driver;
+    }
+    list() {
+        return [...this.#drivers.values()];
+    }
+    connectionClass(name) {
+        return this.require(name).connection;
+    }
+    async resolve(spec, options = {}) {
+        const registered = this.#drivers.get(spec.name);
+        if (registered !== undefined) {
+            if (!descriptorsMatch(spec, {
+                name: registered.name,
+                importPath: registered.importPath,
+                abilityClaim: registered.abilityClaim,
+                multiplicity: registered.multiplicity,
+            })) {
+                throw incompatibleDescriptor(spec.name);
+            }
+            return registered.connection;
+        }
+        const importPath = spec.importPath.trim();
+        if (importPath === "") {
+            throw new Error(`connections: unknown driver ${spec.name}`);
+        }
+        return loadUnresolvedDriverClass(importPath, options);
+    }
+}
+export function openDriverRegistry(providers) {
+    return DriverRegistry.fromDrivers(flattenDrivers(providers));
+}
+export function isDriverRegistry(value) {
+    return (typeof value === "object" &&
+        value !== null &&
+        value[connectionsBrand.registry] === true);
+}
+//# sourceMappingURL=registry.js.map

package/dist/connections/registry.js.map

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

package/dist/connections/resolve.d.ts

@@ -0,0 +1,17 @@
+import { type DriverConnectionClass } from "@inhuman.tools/plexus-expectations/driver";
+export type ResolvePurpose = "adopt" | "discovery" | "execution";
+export type ExternalDriverLoader = (importPath: string) => Promise<unknown>;
+export type ResolveOptions = {
+    readonly purpose?: ResolvePurpose;
+    readonly loadExternal?: ExternalDriverLoader;
+};
+export type DriverResolveSpec = {
+    readonly name: string;
+    readonly importPath: string;
+    readonly abilityClaim?: readonly string[];
+    readonly multiplicity?: string;
+};
+export declare function loadUnresolvedDriverClass(importPath: string, options?: ResolveOptions): Promise<DriverConnectionClass>;
+export declare function descriptorsMatch(spec: DriverResolveSpec, registered: DriverResolveSpec): boolean;
+export declare function incompatibleDescriptor(name: string): Error;
+//# sourceMappingURL=resolve.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.d.ts","sourceRoot":"","sources":["../../src/connections/resolve.ts"],"names":[],"mappings":"AAKA,OAAO,EAA2B,KAAK,qBAAqB,EAAE,MAAM,2CAA2C,CAAC;AAEhH,MAAM,MAAM,cAAc,GAAG,OAAO,GAAG,WAAW,GAAG,WAAW,CAAC;AAEjE,MAAM,MAAM,oBAAoB,GAAG,CAAC,UAAU,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;AAE5E,MAAM,MAAM,cAAc,GAAG;IAC3B,QAAQ,CAAC,OAAO,CAAC,EAAE,cAAc,CAAC;IAClC,QAAQ,CAAC,YAAY,CAAC,EAAE,oBAAoB,CAAC;CAC9C,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,YAAY,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1C,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;CAChC,CAAC;AA0CF,wBAAsB,yBAAyB,CAC7C,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE,cAAmB,GAC3B,OAAO,CAAC,qBAAqB,CAAC,CAkBhC;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,iBAAiB,EAAE,UAAU,EAAE,iBAAiB,GAAG,OAAO,CAYhG;AAED,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,KAAK,CAE1D"}

package/dist/connections/resolve.js

@@ -0,0 +1,86 @@
+/**
+ * One driver-class resolver for adopt, discovery, and execution.
+ * Registered classes win; unregistered importPath uses the injected loader.
+ */
+import { fail, step } from "@inhuman.tools/harness-diagnostics";
+import { isDriverConnectionClass } from "@inhuman.tools/plexus-expectations/driver";
+function resolveFailed(purpose, importPath, error) {
+    const detail = error instanceof Error ? error.message : String(error);
+    switch (purpose) {
+        case "adopt": {
+            fail("connect/adopt resolve", error);
+            throw new Error(`connect/adopt: ${importPath}: ${detail}`);
+        }
+        case "discovery": {
+            fail("connect/models resolve", error);
+            throw new Error(`connect/models: ${importPath}: ${detail}`);
+        }
+        case "execution": {
+            fail("loadDriverModule resolve", error);
+            throw new Error(`loadDriverModule: ${importPath}: ${detail}`);
+        }
+        default: {
+            throw new Error(`connections: ${importPath}: ${detail}`);
+        }
+    }
+}
+function notADriver(purpose, importPath) {
+    switch (purpose) {
+        case "adopt": {
+            throw new Error(`connect/adopt: not a driver: ${importPath}`);
+        }
+        case "discovery": {
+            fail(`connect/models not_a_driver ${importPath}`);
+            throw new Error(`connect/models: not_a_driver:${importPath}`);
+        }
+        case "execution": {
+            fail(`loadDriverModule not_a_driver ${importPath}`);
+            throw new Error(`loadDriverModule: not_a_driver:${importPath}`);
+        }
+        default: {
+            throw new Error(`connections: not_a_driver:${importPath}`);
+        }
+    }
+}
+export async function loadUnresolvedDriverClass(importPath, options = {}) {
+    const load = options.loadExternal;
+    if (load == null) {
+        throw new Error(`connections: unknown driver import ${importPath}`);
+    }
+    if (options.purpose === "discovery") {
+        step(`connect/models load ${importPath}`);
+    }
+    else if (options.purpose === "execution") {
+        step(`loadDriverModule ${importPath}`);
+    }
+    let exported;
+    try {
+        exported = await load(importPath);
+    }
+    catch (error) {
+        resolveFailed(options.purpose, importPath, error);
+    }
+    if (!isDriverConnectionClass(exported))
+        notADriver(options.purpose, importPath);
+    return exported;
+}
+export function descriptorsMatch(spec, registered) {
+    if (spec.name !== registered.name)
+        return false;
+    if (spec.importPath.trim() !== "" && spec.importPath !== registered.importPath) {
+        return false;
+    }
+    if (spec.multiplicity != null && spec.multiplicity !== registered.multiplicity) {
+        return false;
+    }
+    if (spec.abilityClaim == null || spec.abilityClaim.length === 0)
+        return true;
+    if (spec.abilityClaim.length !== registered.abilityClaim?.length)
+        return false;
+    const allowed = new Set(registered.abilityClaim);
+    return spec.abilityClaim.every((token) => allowed.has(token));
+}
+export function incompatibleDescriptor(name) {
+    return new Error(`connections: driver "${name}" descriptor is incompatible`);
+}
+//# sourceMappingURL=resolve.js.map

package/dist/connections/resolve.js.map

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

package/dist/context/index.d.ts

@@ -0,0 +1,2 @@
+export * from "@inhuman.tools/turn/context";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/context/index.ts"],"names":[],"mappings":"AAAA,cAAc,6BAA6B,CAAC"}

package/dist/context/index.js

@@ -0,0 +1,2 @@
+export * from "@inhuman.tools/turn/context";
+//# sourceMappingURL=index.js.map

package/dist/context/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/context/index.ts"],"names":[],"mappings":"AAAA,cAAc,6BAA6B,CAAC"}

package/dist/extensions/adjust-json.d.ts

@@ -0,0 +1,2 @@
+export declare function adjustJson<T>(path: string, transformer: (value: unknown) => T): T;
+//# sourceMappingURL=adjust-json.d.ts.map

package/dist/extensions/adjust-json.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adjust-json.d.ts","sourceRoot":"","sources":["../../src/extensions/adjust-json.ts"],"names":[],"mappings":"AAOA,wBAAgB,UAAU,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,CAAC,GAAG,CAAC,CAUjF"}

package/dist/extensions/adjust-json.js

@@ -0,0 +1,19 @@
+/**
+ * JSON file RMW. A throw from `transformer` leaves the file untouched.
+ * The transformer always returns the value that is written.
+ * The daemon and `inhuman install` share this one writer.
+ */
+import { readFileSync, writeFileSync } from "node:fs";
+export function adjustJson(path, transformer) {
+    let raw;
+    try {
+        raw = JSON.parse(readFileSync(path, "utf8").replace(/^\uFEFF/, ""));
+    }
+    catch {
+        raw = undefined;
+    }
+    const next = transformer(raw);
+    writeFileSync(path, `${JSON.stringify(next, null, 2)}\n`);
+    return next;
+}
+//# sourceMappingURL=adjust-json.js.map

package/dist/extensions/adjust-json.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adjust-json.js","sourceRoot":"","sources":["../../src/extensions/adjust-json.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAEtD,MAAM,UAAU,UAAU,CAAI,IAAY,EAAE,WAAkC;IAC5E,IAAI,GAAY,CAAC;IACjB,IAAI,CAAC;QACH,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAY,CAAC;IACjF,CAAC;IAAC,MAAM,CAAC;QACP,GAAG,GAAG,SAAS,CAAC;IAClB,CAAC;IACD,MAAM,IAAI,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;IAC9B,aAAa,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;IAC1D,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/extensions/behavior.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Behavior is an Arrival capability, not a second interpreter.
+ *
+ * Author-facing names are macros. Each expands to a contour native, and the
+ * native `toJS`s handler lambdas outside a Rosetta region so the wrapper stays
+ * detached after load. A JS callback passed into that wrapper is reverse
+ * Rosetta. The live call context rides AsyncLocalStorage: a detached call
+ * uses Arrival's constant run, which has no capability configuration.
+ */
+import { AsyncLocalStorage } from "node:async_hooks";
+import { EnvCapability } from "@here.build/arrival";
+import { type Ctx } from "./value.js";
+export declare const behaviorAls: AsyncLocalStorage<Ctx>;
+export declare function stampForms(forms: readonly unknown[], text: string): void;
+export declare function behaviorPrelude(names: readonly string[]): string;
+export declare const behaviorCapability: EnvCapability<Record<string, never>, Record<string, never>>;
+//# sourceMappingURL=behavior.d.ts.map

package/dist/extensions/behavior.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"behavior.d.ts","sourceRoot":"","sources":["../../src/extensions/behavior.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAErD,OAAO,EACL,aAAa,EAQd,MAAM,qBAAqB,CAAC;AAQ7B,OAAO,EAA4C,KAAK,GAAG,EAAwB,MAAM,YAAY,CAAC;AAEtG,eAAO,MAAM,WAAW,wBAA+B,CAAC;AAIxD,wBAAgB,UAAU,CAAC,KAAK,EAAE,SAAS,OAAO,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAYxE;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAOhE;AAED,eAAO,MAAM,kBAAkB,6DAsK7B,CAAC"}