@agentshouse/mdruntime 0.1.0-cdb8840578a20 → 0.1.0-cdded6c080913

package/dist/socket/lanes.d.ts

@@ -0,0 +1,20 @@
+export type Live = () => boolean;
+type LaneRules = {
+    generation(): number;
+    continuing(): boolean;
+    stopping(): boolean;
+};
+export type Lanes = {
+    task(lane: string, work: (live: Live) => Promise<void>): Promise<void>;
+    inRoom<T>(locator: string, work: (live: Live) => Promise<T>): Promise<T>;
+    roomTask(locator: string, work: (live: Live) => Promise<void>): Promise<void>;
+    roomWork(): number;
+    current(): Promise<unknown>;
+    finished(): Promise<unknown>;
+    calling(operation: string): boolean;
+    call(operation: string): void;
+    called(operation: string): void;
+};
+export declare function createLanes({ generation, continuing, stopping }: LaneRules): Lanes;
+export {};
+//# sourceMappingURL=lanes.d.ts.map

package/dist/socket/lanes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lanes.d.ts","sourceRoot":"","sources":["../../src/socket/lanes.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC;AAIjC,KAAK,SAAS,GAAG;IACf,UAAU,IAAI,MAAM,CAAC;IACrB,UAAU,IAAI,OAAO,CAAC;IACtB,QAAQ,IAAI,OAAO,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,KAAK,GAAG;IAClB,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACvE,MAAM,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IACzE,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9E,QAAQ,IAAI,MAAM,CAAC;IACnB,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAC5B,QAAQ,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAC7B,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC;IACpC,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CACjC,CAAC;AAIF,wBAAgB,WAAW,CAAC,EAAE,UAAU,EAAE,UAAU,EAAE,QAAQ,EAAE,EAAE,SAAS,GAAG,KAAK,CAgFlF"}

package/dist/socket/lanes.js

@@ -0,0 +1,77 @@
+const ROOM_READS = 256;
+export function createLanes({ generation, continuing, stopping }) {
+    const lanes = new Map();
+    const roomLanes = new Map();
+    const roomReads = { free: ROOM_READS, waiting: [] };
+    const working = new Set();
+    const calling = new Set();
+    let roomWork = 0;
+    async function admittedRead(work) {
+        while (roomReads.free === 0) {
+            await new Promise((admit) => roomReads.waiting.push(admit));
+        }
+        roomReads.free -= 1;
+        try {
+            await work();
+        }
+        finally {
+            roomReads.free += 1;
+            roomReads.waiting.shift()?.();
+        }
+    }
+    function inRoom(locator, work) {
+        roomWork += 1;
+        const ran = (roomLanes.get(locator) ?? Promise.resolve()).then(async () => {
+            try {
+                return await work(continuing);
+            }
+            finally {
+                roomWork -= 1;
+            }
+        });
+        const chain = ran.then(() => undefined, () => undefined);
+        roomLanes.set(locator, chain);
+        working.add(chain);
+        void chain.finally(() => {
+            working.delete(chain);
+            if (roomLanes.get(locator) === chain)
+                roomLanes.delete(locator);
+        });
+        return ran;
+    }
+    return {
+        task(lane, work) {
+            if (stopping())
+                return Promise.resolve();
+            const held = lanes.get(lane);
+            const opened = generation();
+            const current = held?.generation === opened ? held : { generation: opened, chain: Promise.resolve() };
+            const turn = current.generation;
+            const live = () => turn === generation() && continuing();
+            const run = current.chain.then(() => work(live)).catch(() => undefined);
+            current.chain = run;
+            lanes.set(lane, current);
+            working.add(run);
+            void run.finally(() => working.delete(run));
+            return run;
+        },
+        inRoom,
+        roomTask(locator, work) {
+            if (stopping())
+                return Promise.resolve();
+            return inRoom(locator, (live) => admittedRead(() => work(live))).catch(() => undefined);
+        },
+        roomWork: () => roomWork,
+        current: () => Promise.all([...lanes.values()]
+            .filter((held) => held.generation === generation())
+            .map((held) => held.chain)),
+        finished: () => Promise.all(working),
+        calling: (operation) => calling.has(operation),
+        call(operation) {
+            calling.add(operation);
+        },
+        called(operation) {
+            calling.delete(operation);
+        },
+    };
+}

package/dist/socket/reads.d.ts

@@ -0,0 +1,10 @@
+import type { Adapter } from '../adapter.js';
+import type { Reads } from '../bootstrap.js';
+type HeldReads = {
+    readonly reads: Reads;
+    abort(): void;
+    stop(): void;
+};
+export declare function createReads(adapter: Adapter): HeldReads;
+export {};
+//# sourceMappingURL=reads.d.ts.map

package/dist/socket/reads.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reads.d.ts","sourceRoot":"","sources":["../../src/socket/reads.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAiD,MAAM,eAAe,CAAC;AAC5F,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AAE7C,KAAK,SAAS,GAAG;IACf,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IACtB,KAAK,IAAI,IAAI,CAAC;IACd,IAAI,IAAI,IAAI,CAAC;CACd,CAAC;AAWF,wBAAgB,WAAW,CAAC,OAAO,EAAE,OAAO,GAAG,SAAS,CAuBvD"}

package/dist/socket/reads.js

@@ -0,0 +1,31 @@
+function readUntil(read, signal) {
+    if (signal.aborted)
+        return Promise.resolve({ kind: 'transport-uncertainty' });
+    return new Promise((resolve, reject) => {
+        const stop = () => resolve({ kind: 'transport-uncertainty' });
+        signal.addEventListener('abort', stop, { once: true });
+        read.then(resolve, reject).finally(() => signal.removeEventListener('abort', stop));
+    });
+}
+export function createReads(adapter) {
+    let inFlight = new AbortController();
+    const refreshed = adapter.refresh?.bind(adapter);
+    return {
+        reads: {
+            bootstrap: (authorized, request) => readUntil(adapter.bootstrap(authorized, request), inFlight.signal),
+            ...(refreshed === undefined
+                ? {}
+                : {
+                    refresh: (authorized, request) => readUntil(refreshed(authorized, request), inFlight.signal),
+                }),
+            reached: (locator, roomVersion, target) => adapter.reached(locator, roomVersion, target),
+        },
+        abort() {
+            inFlight.abort();
+            inFlight = new AbortController();
+        },
+        stop() {
+            inFlight.abort();
+        },
+    };
+}

package/dist/socket/rooms.d.ts

@@ -0,0 +1,43 @@
+import type { DiscoveredRoom, ProviderRefusal, TypedSelection } from '../adapter.js';
+import type { ModelState } from '../model.js';
+export type RoomDeclaration = Omit<DiscoveredRoom, 'roomVersion' | 'typedSelection'> & {
+    typedSelection?: TypedSelection | null;
+};
+export type Declared = {
+    readonly room: RoomDeclaration | null;
+    readonly available: boolean;
+};
+export type RoomStanding = {
+    readonly unreadable: boolean;
+    readonly refusal: ProviderRefusal | null;
+    readonly unheldModel: ModelState | null;
+    readonly stale: boolean;
+    readonly repairable: {
+        readonly reset: string | undefined;
+    } | null;
+    readonly repairing: boolean;
+    readonly reloadDue: boolean;
+    readonly confirmed: boolean;
+    readonly unpreparable: boolean;
+};
+export type Rooms = {
+    declare(locator: string, declared: Declared): void;
+    declared(locator: string): Declared | undefined;
+    declarations(): ReadonlyMap<string, Declared>;
+    discover(room: DiscoveredRoom): void;
+    discovered(locator: string): DiscoveredRoom | undefined;
+    discoveredRooms(): readonly DiscoveredRoom[];
+    undiscoverAll(): void;
+    standing(locator: string): RoomStanding;
+    stand(locator: string, change: Partial<RoomStanding>): void;
+    standingWhere(held: (room: RoomStanding) => boolean): readonly string[];
+    standAll(change: Partial<RoomStanding>): void;
+    forget(locator: string): void;
+    askAgain(locator: string, ask: () => void): void;
+    readied(locator: string): void;
+    unreadied(): void;
+    connectionLost(lapsed: () => void): void;
+    connectionLive(): void;
+};
+export declare function createRooms(): Rooms;
+//# sourceMappingURL=rooms.d.ts.map

package/dist/socket/rooms.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rooms.d.ts","sourceRoot":"","sources":["../../src/socket/rooms.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACrF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C,MAAM,MAAM,eAAe,GAAG,IAAI,CAAC,cAAc,EAAE,aAAa,GAAG,gBAAgB,CAAC,GAAG;IACrF,cAAc,CAAC,EAAE,cAAc,GAAG,IAAI,CAAC;CACxC,CAAC;AAEF,MAAM,MAAM,QAAQ,GAAG;IAAE,QAAQ,CAAC,IAAI,EAAE,eAAe,GAAG,IAAI,CAAC;IAAC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAA;CAAE,CAAC;AAE9F,MAAM,MAAM,YAAY,GAAG;IACzB,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI,CAAC;IACzC,QAAQ,CAAC,WAAW,EAAE,UAAU,GAAG,IAAI,CAAC;IACxC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,UAAU,EAAE;QAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAAA;KAAE,GAAG,IAAI,CAAC;IACnE,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;CAChC,CAAC;AAcF,MAAM,MAAM,KAAK,GAAG;IAClB,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAAC;IACnD,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS,CAAC;IAChD,YAAY,IAAI,WAAW,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IAC9C,QAAQ,CAAC,IAAI,EAAE,cAAc,GAAG,IAAI,CAAC;IACrC,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAAC;IACxD,eAAe,IAAI,SAAS,cAAc,EAAE,CAAC;IAC7C,aAAa,IAAI,IAAI,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,YAAY,CAAC;IACxC,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG,IAAI,CAAC;IAC5D,aAAa,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,YAAY,KAAK,OAAO,GAAG,SAAS,MAAM,EAAE,CAAC;IACxE,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG,IAAI,CAAC;IAC9C,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,IAAI,GAAG,IAAI,CAAC;IACjD,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,SAAS,IAAI,IAAI,CAAC;IAClB,cAAc,CAAC,MAAM,EAAE,MAAM,IAAI,GAAG,IAAI,CAAC;IACzC,cAAc,IAAI,IAAI,CAAC;CACxB,CAAC;AAQF,wBAAgB,WAAW,IAAI,KAAK,CAsEnC"}

package/dist/socket/rooms.js

@@ -0,0 +1,90 @@
+const STANDING = {
+    unreadable: false,
+    refusal: null,
+    unheldModel: null,
+    stale: false,
+    repairable: null,
+    repairing: false,
+    reloadDue: false,
+    confirmed: false,
+    unpreparable: false,
+};
+// A Room the Provider answers not ready is asked again after these waits, the last repeating, so a chunk build that catches up within seconds installs at once and a long one is asked every 15 seconds.
+const NOT_READY_MS = [1_000, 2_000, 3_000, 5_000, 8_000, 11_000, 15_000];
+// A Room that locks offline stays readable this long after the connection drops, so a laptop waking or changing network keeps working while a disconnected device locks soon after.
+const LOCK_GRACE_MS = 120_000;
+export function createRooms() {
+    const declared = new Map();
+    const discovered = new Map();
+    const standings = new Map();
+    const unready = new Map();
+    let lockGrace = null;
+    function readied(locator) {
+        const held = unready.get(locator);
+        if (held === undefined)
+            return;
+        if (held.timer !== null)
+            clearTimeout(held.timer);
+        unready.delete(locator);
+    }
+    return {
+        declare(locator, room) {
+            declared.set(locator, room);
+        },
+        declared: (locator) => declared.get(locator),
+        declarations: () => declared,
+        discover(room) {
+            discovered.set(room.locator, room);
+        },
+        discovered: (locator) => discovered.get(locator),
+        discoveredRooms: () => [...discovered.values()],
+        undiscoverAll() {
+            discovered.clear();
+        },
+        standing: (locator) => standings.get(locator) ?? STANDING,
+        stand(locator, change) {
+            standings.set(locator, { ...(standings.get(locator) ?? STANDING), ...change });
+        },
+        standingWhere: (held) => [...standings].filter(([, room]) => held(room)).map(([locator]) => locator),
+        standAll(change) {
+            for (const [locator, room] of standings)
+                standings.set(locator, { ...room, ...change });
+        },
+        forget(locator) {
+            declared.delete(locator);
+            discovered.delete(locator);
+            const { repairing, reloadDue } = standings.get(locator) ?? STANDING;
+            standings.set(locator, { ...STANDING, repairing, reloadDue });
+        },
+        askAgain(locator, ask) {
+            const held = unready.get(locator) ?? { tries: 0, timer: null };
+            unready.set(locator, held);
+            if (held.timer !== null)
+                return;
+            const wait = NOT_READY_MS[Math.min(held.tries, NOT_READY_MS.length - 1)];
+            held.tries += 1;
+            held.timer = setTimeout(() => {
+                held.timer = null;
+                ask();
+            }, wait);
+        },
+        readied,
+        unreadied() {
+            for (const locator of [...unready.keys()])
+                readied(locator);
+        },
+        connectionLost(lapsed) {
+            if (lockGrace !== null)
+                return;
+            lockGrace = setTimeout(() => {
+                lockGrace = null;
+                lapsed();
+            }, LOCK_GRACE_MS);
+        },
+        connectionLive() {
+            if (lockGrace !== null)
+                clearTimeout(lockGrace);
+            lockGrace = null;
+        },
+    };
+}

package/dist/socket/session.d.ts

@@ -0,0 +1,39 @@
+import type { Authorization, ProviderRefusal, ServiceMode } from '../adapter.js';
+import { type Cell } from '../cell.js';
+import type { Open } from '../open.js';
+import type { CycleProgress, SyncStatus } from '../status.js';
+export type RefusalReason = 'missing-required-guarantee' | 'revoked-authorization';
+export type ConnectionRefusalCode = Open<RefusalReason>;
+export type ConnectionRefusal = {
+    code: ConnectionRefusalCode;
+    retryable: boolean;
+    reauthorizationOffered: boolean;
+    refusal: ProviderRefusal | null;
+};
+export type Moving = {
+    readonly state: SyncStatus['state'];
+    readonly providerUnreachable: boolean;
+    readonly resting: boolean;
+};
+export type Session = {
+    readonly closed: boolean;
+    readonly stopping: boolean;
+    readonly paused: boolean;
+    readonly authorization: Authorization | undefined;
+    readonly refusal: ConnectionRefusal | null;
+    readonly discoveries: number;
+    readonly roomsNamed: boolean;
+    readonly roomsListed: boolean;
+    readonly serviceMode: ServiceMode;
+    readonly haltedRefusal: boolean;
+    readonly openSignals: number;
+    readonly authorityChanges: number;
+    readonly currencyQueued: number | null;
+    readonly moving: Moving;
+    readonly complete: boolean;
+    readonly recorded: boolean;
+    readonly underway: CycleProgress | null;
+    readonly streamed: CycleProgress | null;
+};
+export declare function createSession(authorization: Authorization | undefined): Cell<Session>;
+//# sourceMappingURL=session.d.ts.map

package/dist/socket/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/socket/session.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACjF,OAAO,EAAc,KAAK,IAAI,EAAE,MAAM,YAAY,CAAC;AACnD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE9D,MAAM,MAAM,aAAa,GAAG,4BAA4B,GAAG,uBAAuB,CAAC;AAEnF,MAAM,MAAM,qBAAqB,GAAG,IAAI,CAAC,aAAa,CAAC,CAAC;AAExD,MAAM,MAAM,iBAAiB,GAAG;IAC9B,IAAI,EAAE,qBAAqB,CAAC;IAC5B,SAAS,EAAE,OAAO,CAAC;IACnB,sBAAsB,EAAE,OAAO,CAAC;IAChC,OAAO,EAAE,eAAe,GAAG,IAAI,CAAC;CACjC,CAAC;AAEF,MAAM,MAAM,MAAM,GAAG;IACnB,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC,OAAO,CAAC,CAAC;IACpC,QAAQ,CAAC,mBAAmB,EAAE,OAAO,CAAC;IACtC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B,CAAC;AAEF,MAAM,MAAM,OAAO,GAAG;IACpB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,aAAa,EAAE,aAAa,GAAG,SAAS,CAAC;IAClD,QAAQ,CAAC,OAAO,EAAE,iBAAiB,GAAG,IAAI,CAAC;IAC3C,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9B,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC;IAClC,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;IAChC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IACvC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,aAAa,GAAG,IAAI,CAAC;IACxC,QAAQ,CAAC,QAAQ,EAAE,aAAa,GAAG,IAAI,CAAC;CACzC,CAAC;AAEF,wBAAgB,aAAa,CAAC,aAAa,EAAE,aAAa,GAAG,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,CAqBrF"}

package/dist/socket/session.js

@@ -0,0 +1,23 @@
+import { createCell } from '../cell.js';
+export function createSession(authorization) {
+    return createCell({
+        closed: false,
+        stopping: false,
+        paused: false,
+        authorization,
+        refusal: null,
+        discoveries: 0,
+        roomsNamed: false,
+        roomsListed: false,
+        serviceMode: 'open',
+        haltedRefusal: false,
+        openSignals: 0,
+        authorityChanges: 0,
+        currencyQueued: null,
+        moving: { state: 'syncing', providerUnreachable: false, resting: false },
+        complete: false,
+        recorded: false,
+        underway: null,
+        streamed: null,
+    });
+}

package/dist/socket.d.ts

@@ -0,0 +1,70 @@
+import type { Adapter, Authorization, ConversationEvent, Discovery, HeldRoom, RoomStreamEvent, ServiceMode } from './adapter.js';
+import type { Reads } from './bootstrap.js';
+import type { Cell } from './cell.js';
+import type { Log } from './log.js';
+import { type Admission } from './socket/admission.js';
+import { type Answers } from './socket/answers.js';
+import { type Lanes } from './socket/lanes.js';
+import { type Rooms } from './socket/rooms.js';
+import { type Session } from './socket/session.js';
+export type { Live } from './socket/lanes.js';
+export type { Declared, RoomDeclaration } from './socket/rooms.js';
+export type { ConnectionRefusal, ConnectionRefusalCode, Moving, RefusalReason, } from './socket/session.js';
+type SocketEvent = {
+    readonly kind: 'opened';
+} | {
+    readonly kind: 'discovered';
+    readonly discovery: Discovery;
+    readonly missed: boolean;
+} | {
+    readonly kind: 'closed';
+    readonly revoked: boolean;
+    readonly lost: boolean;
+    readonly opened: boolean;
+} | Exclude<RoomStreamEvent, {
+    kind: 'opened' | 'discovered' | 'closed';
+}>;
+export type RuntimeSocket = Admission & Answers & {
+    readonly reads: Reads;
+    readonly streamed: boolean;
+    readonly session: Cell<Session>;
+    readonly rooms: Rooms;
+    readonly lanes: Lanes;
+    readonly ready: Promise<void>;
+    readonly firstDiscovery: Promise<void>;
+    conversations(): Adapter['conversations'];
+    search(): Adapter['search'];
+    discover(authorized: Authorization): ReturnType<NonNullable<Adapter['discover']>> | undefined;
+    follows: Adapter['follows'];
+    mutate: Adapter['mutate'];
+    binary: Adapter['binary'];
+    link: Adapter['link'];
+    attach: Adapter['attach'];
+    history: Adapter['history'];
+    action: Adapter['action'];
+    authorize(): Promise<void>;
+    observe(listen: (event: SocketEvent) => void): void;
+    observeConversations(listen: (event: ConversationEvent) => void): void;
+    observeServiceMode(listen: (mode: ServiceMode) => void): void;
+    close(): void;
+    readyFromStore(): void;
+    notifyReady(): void;
+    closed(): boolean;
+    stopping(): boolean;
+    continuing(): boolean;
+    reached(): boolean;
+    writesHeld(): boolean;
+    haltedSince(opens: number): boolean;
+    isOpen(): boolean;
+    isAnnounced(): boolean;
+    isHanded(): boolean;
+    generation(): number;
+    naming(): boolean;
+    hand(rooms: readonly HeldRoom[]): void;
+    name(room: HeldRoom): void;
+    named(): void;
+    abortReads(): void;
+    stopReads(): void;
+};
+export declare function createSocket(adapter: Adapter, journal: Log, authorization: Authorization | undefined): RuntimeSocket;
+//# sourceMappingURL=socket.d.ts.map

package/dist/socket.d.ts.map

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

package/dist/socket.js

@@ -0,0 +1,175 @@
+import { createAdmission } from './socket/admission.js';
+import { createAnswers } from './socket/answers.js';
+import { createLanes } from './socket/lanes.js';
+import { createReads } from './socket/reads.js';
+import { createRooms } from './socket/rooms.js';
+import { createSession } from './socket/session.js';
+export function createSocket(adapter, journal, authorization) {
+    const held = createReads(adapter);
+    const admission = createAdmission();
+    const answers = createAnswers();
+    const session = createSession(authorization);
+    const rooms = createRooms();
+    let readyFromStore = () => { };
+    const ready = new Promise((resolve) => {
+        readyFromStore = resolve;
+    });
+    let notifyDiscovered = () => { };
+    const firstDiscovery = new Promise((resolve) => {
+        notifyDiscovered = resolve;
+    });
+    let withdrawStream;
+    let withdrawConversations;
+    let withdrawServiceMode;
+    let socketOpen = false;
+    let announced = false;
+    let missedChange = false;
+    let handed = false;
+    let naming = 0;
+    let generation = 0;
+    function closed() {
+        return session.now().closed;
+    }
+    function continuing() {
+        const { closed, paused } = session.now();
+        return !closed && !paused;
+    }
+    function received(event, listen) {
+        if (event.kind === 'opened') {
+            socketOpen = true;
+            announced = false;
+            handed = false;
+            naming = 0;
+            generation += 1;
+            listen(event);
+        }
+        else if (event.kind === 'discovered') {
+            if (!socketOpen)
+                return;
+            announced = true;
+            const missed = missedChange;
+            missedChange = false;
+            listen({ ...event, missed });
+        }
+        else if (event.kind === 'closed') {
+            const opened = announced;
+            socketOpen = false;
+            announced = false;
+            missedChange ||= event.authorityChanged;
+            handed = false;
+            naming = 0;
+            listen({ kind: 'closed', revoked: event.revoked, lost: event.lost, opened });
+        }
+        else
+            listen(event);
+    }
+    return {
+        ...admission,
+        ...answers,
+        reads: held.reads,
+        streamed: adapter.roomStream !== undefined,
+        session,
+        rooms,
+        lanes: createLanes({
+            generation: () => generation,
+            continuing,
+            stopping: () => session.now().stopping,
+        }),
+        ready,
+        firstDiscovery,
+        conversations: () => adapter.conversations,
+        search: () => adapter.search,
+        discover: (authorized) => adapter.discover?.(authorized),
+        follows: (locator, roomVersion, next) => adapter.follows(locator, roomVersion, next),
+        mutate: (authorized, request, keepUpload) => adapter.mutate(authorized, request, keepUpload),
+        binary: (authorized, request) => adapter.binary(authorized, request),
+        link: (authorized, request) => adapter.link(authorized, request),
+        attach: (authorized, request) => adapter.attach(authorized, request),
+        history: (authorized, request) => adapter.history(authorized, request),
+        action: (authorized, request) => adapter.action(authorized, request),
+        async authorize() {
+            if (session.now().authorization !== undefined)
+                return;
+            try {
+                session.set({ authorization: await adapter.authorize() });
+                journal.record('connection authorize');
+            }
+            catch (error) {
+                journal.record('connection authorize transport-uncertainty');
+                throw error;
+            }
+        },
+        observe(listen) {
+            const stream = adapter.roomStream;
+            if (stream === undefined || withdrawStream !== undefined)
+                return;
+            withdrawStream = stream.observe((event) => {
+                const { closed, stopping } = session.now();
+                if (!closed && !stopping)
+                    received(event, listen);
+            });
+        },
+        observeConversations(listen) {
+            const stream = adapter.conversations;
+            if (stream === undefined || withdrawConversations !== undefined)
+                return;
+            withdrawConversations = stream.observe(listen);
+        },
+        observeServiceMode(listen) {
+            withdrawServiceMode = adapter.serviceMode?.observe(listen);
+        },
+        close() {
+            session.set({ closed: true });
+            notifyDiscovered();
+            rooms.unreadied();
+            rooms.connectionLive();
+            withdrawStream?.();
+            withdrawStream = undefined;
+            withdrawConversations?.();
+            withdrawConversations = undefined;
+            withdrawServiceMode?.();
+        },
+        readyFromStore: () => readyFromStore(),
+        notifyReady() {
+            notifyDiscovered();
+            readyFromStore();
+        },
+        closed,
+        stopping: () => session.now().stopping,
+        continuing,
+        reached() {
+            const { moving, refusal } = session.now();
+            return (socketOpen || !moving.providerUnreachable) && refusal === null;
+        },
+        writesHeld() {
+            const { serviceMode, haltedRefusal } = session.now();
+            return serviceMode === 'write-halted' || haltedRefusal;
+        },
+        haltedSince(opens) {
+            const { serviceMode, openSignals } = session.now();
+            if (serviceMode === 'open' && openSignals !== opens)
+                return false;
+            session.set({ haltedRefusal: true });
+            return true;
+        },
+        isOpen: () => socketOpen,
+        isAnnounced: () => announced,
+        isHanded: () => handed,
+        generation: () => generation,
+        naming: () => naming !== 0,
+        hand(rooms) {
+            naming += 1;
+            adapter.roomStream?.hold(rooms);
+            handed = true;
+        },
+        name(room) {
+            naming += 1;
+            adapter.roomStream?.hold([room]);
+        },
+        named() {
+            naming = Math.max(0, naming - 1);
+        },
+        abortReads: held.abort,
+        stopReads: held.stop,
+    };
+}

package/dist/source.d.ts

@@ -0,0 +1,61 @@
+export type HouseSource = {
+    readonly kind: 'request';
+    readonly request: string;
+    readonly agentFunction: RequestAgentFunction | null;
+    readonly requester: {
+        readonly name: string;
+        readonly room: boolean;
+    };
+    readonly room: {
+        readonly ref: string;
+        readonly name: string;
+    };
+    readonly approved: string | null;
+} | {
+    readonly kind: 'mail';
+    readonly request: string;
+    readonly room: string;
+    readonly report: boolean;
+    readonly agent: string;
+    readonly owner: string;
+    readonly approved: string | null;
+    readonly declined: string | null;
+} | {
+    readonly kind: 'trigger';
+    readonly customer: boolean;
+    readonly trigger: string;
+    readonly room: {
+        readonly ref: string;
+        readonly name: string;
+    };
+} | {
+    readonly kind: 'conversation';
+    readonly conversation: {
+        readonly id: string;
+        readonly name: string;
+    };
+    readonly agent: string;
+} | {
+    readonly kind: 'declined';
+    readonly agent: string;
+    readonly owner: string;
+};
+export type ChatRequest = {
+    readonly request: string;
+    readonly room: string;
+    readonly message?: string;
+};
+export type ChatRoomRequest = {
+    readonly request: string;
+    readonly room: {
+        readonly ref: string;
+        readonly name: string;
+    };
+};
+type RequestAgentFunction = {
+    readonly name: string;
+    readonly version: number;
+};
+export declare function sourceOf(value: unknown, sender: string | null): HouseSource | null;
+export {};
+//# sourceMappingURL=source.d.ts.map