@agentshouse/mdruntime 0.1.0-cd50a4607cb7d → 0.1.0-cd574a610e9c8

package/dist/socket.d.ts

@@ -0,0 +1,67 @@
+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 { Retries } from './retried.js';
+import { type Admission } from './socket/admission.js';
+import { type Answers } from './socket/answers.js';
+import { type Lanes } from './socket/lanes.js';
+import { type Session } from './socket/session.js';
+export type { KeptSender, Live } from './socket/lanes.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 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, retries: Retries, 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,164 @@
+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 { createSession } from './socket/session.js';
+export function createSocket(adapter, retries, authorization) {
+    const held = createReads(adapter);
+    const admission = createAdmission();
+    const answers = createAnswers();
+    const session = createSession(authorization);
+    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,
+        lanes: createLanes({
+            generation: () => generation,
+            continuing,
+            stopping: () => session.now().stopping,
+            failed: (locator, error) => retries.failed('download', locator, error),
+        }),
+        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;
+            session.set({ authorization: await adapter.authorize() });
+        },
+        observe(listen) {
+            const stream = adapter.roomStream;
+            if (stream === 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)
+                return;
+            withdrawConversations = stream.observe(listen);
+        },
+        observeServiceMode(listen) {
+            withdrawServiceMode = adapter.serviceMode?.observe(listen);
+        },
+        close() {
+            session.set({ closed: true });
+            notifyDiscovered();
+            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,59 @@
+export type RequestAnswer = 'at_once' | 'ask_me' | 'off';
+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 handle: string;
+        readonly name: string;
+    };
+    readonly sent: string;
+    readonly instruction: string | null;
+    readonly answer: RequestAnswer | null;
+    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;
+};
+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

package/dist/source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"source.d.ts","sourceRoot":"","sources":["../src/source.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,QAAQ,GAAG,KAAK,CAAC;AAIzD,MAAM,MAAM,WAAW,GACnB;IACE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,aAAa,EAAE,oBAAoB,GAAG,IAAI,CAAC;IACpD,QAAQ,CAAC,SAAS,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAA;KAAE,CAAC;IACtE,QAAQ,CAAC,IAAI,EAAE;QAAE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IACxF,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,QAAQ,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI,CAAC;IACtC,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CAClC,GACD;IACE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CAClC,GACD;IACE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE;QAAE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;CAChE,GACD;IACE,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;IAC9B,QAAQ,CAAC,YAAY,EAAE;QAAE,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IACtE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB,GACD;IAAE,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAElF,MAAM,MAAM,WAAW,GAAG;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B,CAAC;AAEF,KAAK,oBAAoB,GAAG;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AA+ChF,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,WAAW,GAAG,IAAI,CA6ClF"}

package/dist/source.js

@@ -0,0 +1,93 @@
+import { record, text } from './read.js';
+const ANSWERS = ['at_once', 'ask_me', 'off'];
+function agentFunctionOf(value) {
+    if (value === null)
+        return null;
+    const agentFunction = record(value);
+    const name = text(agentFunction, 'name');
+    const version = agentFunction.version;
+    return name === null || typeof version !== 'number' ? undefined : { name, version };
+}
+function answerOf(value) {
+    return ANSWERS.find((one) => one === value) ?? null;
+}
+function requestOf(source) {
+    const request = text(source, 'request');
+    const agentFunction = agentFunctionOf(source.agent_function);
+    const requester = record(source.requester);
+    const by = text(requester, 'name');
+    const room = record(source.room);
+    const ref = text(room, 'ref');
+    const handle = text(room, 'handle');
+    const called = text(room, 'name');
+    const sent = typeof source.sent === 'string' ? source.sent : null;
+    if (request === null ||
+        agentFunction === undefined ||
+        by === null ||
+        ref === null ||
+        handle === null ||
+        called === null ||
+        sent === null)
+        return null;
+    return {
+        kind: 'request',
+        request,
+        agentFunction,
+        requester: { name: by, room: text(requester, 'room') !== null },
+        room: { ref, handle, name: called },
+        sent,
+        instruction: text(source, 'instruction'),
+        answer: answerOf(source.answer),
+        approved: text(source, 'approved_at'),
+    };
+}
+export function sourceOf(value, sender) {
+    const source = record(value);
+    if (source.kind === 'request')
+        return requestOf(source);
+    if (source.kind === 'trigger') {
+        const trigger = text(record(source.trigger), 'description');
+        const room = record(source.room);
+        const ref = text(room, 'ref');
+        const called = text(room, 'name');
+        return trigger === null || ref === null || called === null
+            ? null
+            : {
+                kind: 'trigger',
+                customer: sender === 'customer',
+                trigger,
+                room: { ref, name: called },
+            };
+    }
+    if (source.kind === 'conversation') {
+        const conversation = record(source.conversation);
+        const id = text(conversation, 'id');
+        const name = text(conversation, 'name');
+        const agent = text(record(source.agent), 'name');
+        return id === null || name === null || agent === null
+            ? null
+            : { kind: 'conversation', conversation: { id, name }, agent };
+    }
+    if (source.kind !== 'mail' && source.kind !== 'declined')
+        return null;
+    const agent = text(record(source.agent), 'name');
+    const owner = text(record(source.owner), 'name');
+    if (agent === null || owner === null)
+        return null;
+    if (source.kind === 'declined')
+        return { kind: 'declined', agent, owner };
+    const request = text(source, 'request');
+    const room = text(source, 'room');
+    return request === null || room === null
+        ? null
+        : {
+            kind: 'mail',
+            request,
+            room,
+            report: sender === 'report',
+            agent,
+            owner,
+            approved: text(source, 'approved_at'),
+            declined: text(source, 'declined_at'),
+        };
+}

package/dist/status.d.ts

@@ -1,19 +1,20 @@
 import type { Open } from './open.js';
-import type { ProviderRefusal } from './adapter.js';
 import type { ReturnReason } from './room-draft.js';
 export type AttentionEntry = {
     room: string;
     path: string;
     returned: ReturnReason;
-} | {
+};
+export type UnsentChange = {
     room: string;
-    refusal: ProviderRefusal;
+    path: string;
 };
 export type SyncStatus = {
     state: Open<'pending' | 'syncing' | 'synced'>;
     lastCompleted: string | null;
     providerUnreachable: boolean;
     attentionRequired: readonly AttentionEntry[];
+    unsent: readonly UnsentChange[];
     reset: string | null;
 };
 export type CycleProgress = {
@@ -21,7 +22,5 @@ export type CycleProgress = {
     reachable: boolean;
 };
 export declare const STARTING: SyncStatus;
-export declare function transferring(status: SyncStatus): SyncStatus;
-export declare function saving(status: SyncStatus): SyncStatus;
 export declare function same(one: SyncStatus, other: SyncStatus): boolean;
 //# sourceMappingURL=status.d.ts.map

package/dist/status.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../src/status.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAEpD,MAAM,MAAM,cAAc,GACtB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,YAAY,CAAA;CAAE,GACtD;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,eAAe,CAAA;CAAE,CAAC;AAE/C,MAAM,MAAM,UAAU,GAAG;IACvB,KAAK,EAAE,IAAI,CAAC,SAAS,GAAG,SAAS,GAAG,QAAQ,CAAC,CAAC;IAC9C,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,mBAAmB,EAAE,OAAO,CAAC;IAC7B,iBAAiB,EAAE,SAAS,cAAc,EAAE,CAAC;IAC7C,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,QAAQ,EAAE,OAAO,CAAC;IAClB,SAAS,EAAE,OAAO,CAAC;CACpB,CAAC;AAEF,eAAO,MAAM,QAAQ,EAAE,UAMtB,CAAC;AAEF,wBAAgB,YAAY,CAAC,MAAM,EAAE,UAAU,GAAG,UAAU,CAE3D;AAED,wBAAgB,MAAM,CAAC,MAAM,EAAE,UAAU,GAAG,UAAU,CAErD;AAED,wBAAgB,IAAI,CAAC,GAAG,EAAE,UAAU,EAAE,KAAK,EAAE,UAAU,GAAG,OAAO,CAQhE"}
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../src/status.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAEpD,MAAM,MAAM,cAAc,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,YAAY,CAAA;CAAE,CAAC;AAEpF,MAAM,MAAM,YAAY,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAE1D,MAAM,MAAM,UAAU,GAAG;IACvB,KAAK,EAAE,IAAI,CAAC,SAAS,GAAG,SAAS,GAAG,QAAQ,CAAC,CAAC;IAC9C,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,mBAAmB,EAAE,OAAO,CAAC;IAC7B,iBAAiB,EAAE,SAAS,cAAc,EAAE,CAAC;IAC7C,MAAM,EAAE,SAAS,YAAY,EAAE,CAAC;IAChC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,QAAQ,EAAE,OAAO,CAAC;IAClB,SAAS,EAAE,OAAO,CAAC;CACpB,CAAC;AAEF,eAAO,MAAM,QAAQ,EAAE,UAOtB,CAAC;AAEF,wBAAgB,IAAI,CAAC,GAAG,EAAE,UAAU,EAAE,KAAK,EAAE,UAAU,GAAG,OAAO,CAShE"}

package/dist/status.js

@@ -3,18 +3,14 @@ export const STARTING = {
     lastCompleted: null,
     providerUnreachable: false,
     attentionRequired: [],
+    unsent: [],
     reset: null,
 };
-export function transferring(status) {
-    return { ...status, state: 'syncing' };
-}
-export function saving(status) {
-    return { ...status, state: 'pending' };
-}
 export function same(one, other) {
     return (one.state === other.state &&
         one.lastCompleted === other.lastCompleted &&
         one.providerUnreachable === other.providerUnreachable &&
         one.reset === other.reset &&
-        JSON.stringify(one.attentionRequired) === JSON.stringify(other.attentionRequired));
+        JSON.stringify(one.attentionRequired) === JSON.stringify(other.attentionRequired) &&
+        JSON.stringify(one.unsent) === JSON.stringify(other.unsent));
 }

package/dist/store/installs.d.ts

@@ -0,0 +1,30 @@
+import type { InstallationAmount } from '../readiness.js';
+import type { TransferRecord } from './records.js';
+type OwedIndex = {
+    readonly bytes: number;
+    readonly text: number;
+};
+export type RoomInstall = {
+    readonly transfer: TransferRecord | null;
+    readonly arrived: number | null;
+    readonly streaming: boolean;
+    readonly underived: number;
+    readonly unindexed: readonly OwedIndex[];
+    readonly startedOver: InstallationAmount | null;
+    readonly installing: boolean;
+    readonly catching: boolean;
+    readonly highest: string | null;
+    readonly beyondHorizon: boolean;
+    readonly confirmations: number;
+};
+export declare const NO_INSTALL: RoomInstall;
+export type Installs = {
+    of(locator: string): RoomInstall;
+    change(locator: string, next: (held: RoomInstall) => RoomInstall): void;
+    underway(among: readonly string[] | null): ReadonlySet<string>;
+    transferring(): readonly string[];
+    arrivalsDue(locator: string, now: number, everyMs: number): readonly string[];
+};
+export declare function createInstalls(): Installs;
+export {};
+//# sourceMappingURL=installs.d.ts.map

package/dist/store/installs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"installs.d.ts","sourceRoot":"","sources":["../../src/store/installs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAC1D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAEnD,KAAK,SAAS,GAAG;IAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAEnE,MAAM,MAAM,WAAW,GAAG;IACxB,QAAQ,CAAC,QAAQ,EAAE,cAAc,GAAG,IAAI,CAAC;IACzC,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,SAAS,SAAS,EAAE,CAAC;IACzC,QAAQ,CAAC,WAAW,EAAE,kBAAkB,GAAG,IAAI,CAAC;IAChD,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;IAChC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAChC,CAAC;AAEF,eAAO,MAAM,UAAU,EAAE,WAYxB,CAAC;AAEF,MAAM,MAAM,QAAQ,GAAG;IACrB,EAAE,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW,CAAC;IACjC,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,IAAI,EAAE,WAAW,KAAK,WAAW,GAAG,IAAI,CAAC;IACxE,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC;IAC/D,YAAY,IAAI,SAAS,MAAM,EAAE,CAAC;IAClC,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CAAC;CAC/E,CAAC;AAEF,wBAAgB,cAAc,IAAI,QAAQ,CA8BzC"}

package/dist/store/installs.js

@@ -0,0 +1,40 @@
+export const NO_INSTALL = {
+    transfer: null,
+    arrived: null,
+    streaming: false,
+    underived: 0,
+    unindexed: [],
+    startedOver: null,
+    installing: false,
+    catching: false,
+    highest: null,
+    beyondHorizon: false,
+    confirmations: 0,
+};
+export function createInstalls() {
+    const rooms = new Map();
+    let arrivalReported = 0;
+    const arrived = new Set();
+    function matching(held) {
+        return [...rooms].filter(([, room]) => held(room)).map(([locator]) => locator);
+    }
+    return {
+        of: (locator) => rooms.get(locator) ?? NO_INSTALL,
+        change(locator, next) {
+            rooms.set(locator, next(rooms.get(locator) ?? NO_INSTALL));
+        },
+        underway: (among) => new Set(among === null
+            ? matching(({ installing }) => installing)
+            : among.filter((locator) => rooms.get(locator)?.installing === true)),
+        transferring: () => matching(({ transfer }) => transfer !== null),
+        arrivalsDue(locator, now, everyMs) {
+            arrived.add(locator);
+            if (now - arrivalReported < everyMs)
+                return [];
+            arrivalReported = now;
+            const due = [...arrived];
+            arrived.clear();
+            return due;
+        },
+    };
+}

package/dist/store/readiness.d.ts

@@ -0,0 +1,11 @@
+export type ReadinessQueue<W, S> = {
+    add(watch: W): () => void;
+    held(watch: W): boolean;
+    kept(watch: W): S | undefined;
+    keep(watch: W, shown: S): void;
+    owe(watches: readonly W[]): void;
+    queue(rooms?: readonly string[]): void;
+    close(): void;
+};
+export declare function createReadinessQueue<W, S>(deliver: (owed: readonly W[], rooms: ReadonlySet<string> | null) => Promise<void>, unpublished: (error: unknown) => void): ReadinessQueue<W, S>;
+//# sourceMappingURL=readiness.d.ts.map

package/dist/store/readiness.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"readiness.d.ts","sourceRoot":"","sources":["../../src/store/readiness.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,cAAc,CAAC,CAAC,EAAE,CAAC,IAAI;IACjC,GAAG,CAAC,KAAK,EAAE,CAAC,GAAG,MAAM,IAAI,CAAC;IAC1B,IAAI,CAAC,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC;IACxB,IAAI,CAAC,KAAK,EAAE,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC;IAC9B,IAAI,CAAC,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI,CAAC;IAC/B,GAAG,CAAC,OAAO,EAAE,SAAS,CAAC,EAAE,GAAG,IAAI,CAAC;IACjC,KAAK,CAAC,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI,CAAC;IACvC,KAAK,IAAI,IAAI,CAAC;CACf,CAAC;AAWF,wBAAgB,oBAAoB,CAAC,CAAC,EAAE,CAAC,EACvC,OAAO,EAAE,CAAC,IAAI,EAAE,SAAS,CAAC,EAAE,EAAE,KAAK,EAAE,WAAW,CAAC,MAAM,CAAC,GAAG,IAAI,KAAK,OAAO,CAAC,IAAI,CAAC,EACjF,WAAW,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,GACpC,cAAc,CAAC,CAAC,EAAE,CAAC,CAAC,CAwDtB"}

package/dist/store/readiness.js

@@ -0,0 +1,68 @@
+function joined(held, rooms) {
+    if (held === null || rooms === null)
+        return null;
+    for (const room of rooms)
+        held.add(room);
+    return held;
+}
+export function createReadinessQueue(deliver, unpublished) {
+    const watches = new Set();
+    const owed = new Set();
+    const lastShown = new Map();
+    let owedRooms = new Set();
+    let queued = false;
+    let queuedRooms = new Set();
+    let shown = Promise.resolve();
+    function owing(owe, rooms) {
+        const waiting = owed.size > 0;
+        for (const watch of owe)
+            owed.add(watch);
+        owedRooms = joined(owedRooms, rooms);
+        if (waiting)
+            return;
+        shown = shown
+            .then(async () => {
+            const due = [...owed];
+            const touched = owedRooms;
+            owed.clear();
+            owedRooms = new Set();
+            await deliver(due, touched);
+        })
+            .catch(unpublished);
+    }
+    return {
+        add(watch) {
+            watches.add(watch);
+            return () => {
+                watches.delete(watch);
+                lastShown.delete(watch);
+            };
+        },
+        held: (watch) => watches.has(watch),
+        kept: (watch) => lastShown.get(watch),
+        keep(watch, kept) {
+            if (watches.has(watch))
+                lastShown.set(watch, kept);
+        },
+        owe: (owe) => owing(owe, null),
+        queue(rooms) {
+            if (watches.size === 0)
+                return;
+            queuedRooms = joined(queuedRooms, rooms ?? null);
+            if (queued)
+                return;
+            queued = true;
+            queueMicrotask(() => {
+                queued = false;
+                const touched = queuedRooms;
+                queuedRooms = new Set();
+                if (watches.size > 0)
+                    owing([...watches], touched);
+            });
+        },
+        close() {
+            watches.clear();
+            lastShown.clear();
+        },
+    };
+}