@agentshouse/mdruntime 0.1.0-ce41fec66d91b → 0.1.0-ce5b3c1e6ea87

package/dist/surface.d.ts

@@ -0,0 +1,88 @@
+import type { DocumentQuery, GroupQuery } from '@agentshouse/mdmodel';
+import { type HistoryQuery } from './actions.js';
+import type { Member, ServiceMode } from './adapter.js';
+import type { WrittenBy } from './change.js';
+import { type ChatDraftSurface, type ConversationEntry, type ConversationAgent, type ConversationOptions, type ConversationSurface, type ConversationView } from './conversation.js';
+import type { UnsentWork } from './durability.js';
+import type { FiguresResult } from './figures.js';
+import { type Holdings } from './holdings.js';
+import { type AppRoom } from './listing.js';
+import { type TypesResult } from './model.js';
+import { type Observation } from './observation.js';
+import type { HistoryAnswer, QueueEntry, Resolution, CallResult } from './outcome.js';
+import { type ReadinessPort } from './preparation.js';
+import type { DocumentResult, GroupResult, PendingResult } from './query.js';
+import { type NarrowedView, type PortReach, type RuntimeView } from './reach.js';
+import type { Persistence, Readiness } from './readiness.js';
+import type { ObservedRead } from './reads.js';
+import type { RoomDraft } from './room-draft.js';
+import { type PresentationSurface, type RoomDraftSurface } from './room-drafts.js';
+import type { Runtime } from './runtime.js';
+import { type BinaryFileSurface, type SavedParts, type SavedRoomDraft, type SaveResult } from './saves.js';
+import type { SearchRequest, SearchResult } from './search.js';
+import { type EntrySeed } from './seed.js';
+import type { ConnectionRefusal } from './socket.js';
+import type { SyncStatus } from './status.js';
+export type RoomSchemas = {
+    collection: TypesResult;
+    typedSelection: TypesResult | null;
+};
+export type MdRuntime = {
+    loaded(): Promise<void>;
+    rooms(): Promise<readonly AppRoom[]>;
+    query: {
+        (query: DocumentQuery): Promise<DocumentResult | PendingResult>;
+        (query: GroupQuery): Promise<GroupResult | PendingResult>;
+    };
+    search(request: SearchRequest): Promise<SearchResult>;
+    types(locator: string): Promise<RoomSchemas>;
+    roomDraft: RoomDraftSurface;
+    conversation: ConversationSurface;
+    chatDraft: ChatDraftSurface;
+    presentation: PresentationSurface;
+    save(room: string, roomDrafts: readonly SavedRoomDraft[], writtenBy?: WrittenBy): Promise<SaveResult>;
+    saveParts(room: string, parts: readonly SavedParts[], writtenBy?: WrittenBy): Promise<SaveResult>;
+    history(locator: string, path: string, query?: HistoryQuery): Promise<HistoryAnswer>;
+    resolve(room: string, path: string, destination: string): Promise<Resolution>;
+    binaryFile: BinaryFileSurface;
+    call(name: string, input: unknown): Promise<CallResult>;
+    reached(locator: string, roomVersion: string, path?: string): Promise<boolean>;
+    log(): string;
+    persistence(): boolean;
+    retry(): Promise<void>;
+    cleanUp(): Promise<number>;
+    unsent(): Promise<readonly UnsentWork[]>;
+    reset(): Promise<void>;
+    readAgain(): Promise<void>;
+    observe: {
+        (topic: 'rooms'): Promise<Observation<readonly AppRoom[]>>;
+        (topic: 'readiness'): Promise<Observation<Readiness>>;
+        (topic: 'connection-refusal'): Promise<Observation<ConnectionRefusal | null>>;
+        (topic: 'storage-loss'): Promise<Observation<string | null>>;
+        (topic: 'sync-status'): Promise<Observation<SyncStatus>>;
+        (topic: 'service-mode'): Promise<Observation<ServiceMode>>;
+        (topic: 'member'): Promise<Observation<Member | null>>;
+        (topic: 'authority-changes'): Promise<Observation<number>>;
+        (topic: 'query', query: DocumentQuery): Promise<Observation<DocumentResult | PendingResult>>;
+        (topic: 'query', query: GroupQuery): Promise<Observation<GroupResult | PendingResult>>;
+        (topic: 'queue', locator: string): Promise<Observation<readonly QueueEntry[]>>;
+        (topic: 'room-drafts'): Promise<Observation<readonly RoomDraft[]>>;
+        (topic: 'presentation', app: string): Promise<Observation<unknown>>;
+        (topic: 'conversation', conversation: string, options: ConversationOptions): Promise<Observation<ConversationView>>;
+        (topic: 'conversations'): Promise<Observation<readonly ConversationEntry[]>>;
+        (topic: 'agents'): Promise<Observation<readonly ConversationAgent[]>>;
+        (topic: 'figures'): Promise<Observation<FiguresResult>>;
+        (topic: 'holdings'): Promise<Observation<Holdings>>;
+        (topic: 'read', name: string, input: unknown): Promise<Observation<ObservedRead>>;
+    };
+    reauthorize(): Promise<void>;
+};
+export type RuntimeTopic = 'rooms' | 'readiness' | 'connection-refusal' | 'storage-loss' | 'sync-status' | 'service-mode' | 'member' | 'authority-changes' | 'query' | 'queue' | 'room-drafts' | 'presentation' | 'conversation' | 'conversations' | 'agents' | 'figures' | 'holdings' | 'read';
+export type ComposedRuntime = RuntimeView & {
+    seed(entry: EntrySeed): void;
+    stop(): Promise<void>;
+    persisted(answer: Persistence): void;
+    within(reach: PortReach | null, port: ReadinessPort): NarrowedView;
+};
+export declare function composedRuntime(runtime: Runtime): ComposedRuntime;
+//# sourceMappingURL=surface.d.ts.map

package/dist/surface.d.ts.map

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

package/dist/surface.js

@@ -0,0 +1,223 @@
+import { called, located, readHistory, resolveReference } from './actions.js';
+import { chatDraftSurface, conversationSurface, watchConversation, watchConversationAgents, watchConversationList, } from './conversation.js';
+import { CLEANED_TOPIC, watchHoldings } from './holdings.js';
+import { reachedBy, writtenAfter } from './install.js';
+import { declarationOf, listingNow, modelIn, shownRooms } from './listing.js';
+import { stop } from './lifecycle.js';
+import { locked, lockedRooms, watchLocks } from './locks.js';
+import { modelTypes, NO_MODEL } from './model.js';
+import { observing } from './observation.js';
+import { watchReadiness } from './preparation.js';
+import { planned, rowsQuery, searched, watchPlan, watchPlanned } from './queries.js';
+import { narrowed, } from './reach.js';
+import { presentationSurface, roomDraftSurface, watchPresentation, watchRoomDrafts, } from './room-drafts.js';
+import { binaryFileSurface, saveParts, saveRoomDrafts, } from './saves.js';
+import { keepEntrySeed } from './seed.js';
+import { AUTHORITY_TOPIC, emitKnownRooms, entriesOf, MEMBER_TOPIC, queueTopic, REFUSAL_TOPIC, ROOMS_TOPIC, SERVICE_MODE_TOPIC, STATUS_TOPIC, STORAGE_LOSS_TOPIC, } from './shown.js';
+import { OPENING_LANE, sync } from './sync.js';
+function told(store, topic, deliver, current) {
+    const watcher = store.watch(topic, deliver);
+    deliver(current);
+    return watcher.stop;
+}
+function watchRooms(runtime, deliver) {
+    const { store } = runtime;
+    const watcher = store.watch(ROOMS_TOPIC, deliver);
+    emitKnownRooms(runtime);
+    return () => {
+        watcher.stop();
+        if (store.watching(ROOMS_TOPIC, 'ready').length === 0)
+            store.device.set({ roomsShown: null });
+    };
+}
+function watchMember({ store }, deliver) {
+    const watcher = store.watch(MEMBER_TOPIC, deliver);
+    void store
+        .open()
+        .then((local) => local.facts())
+        .then(({ member }) => {
+        if (watcher.held())
+            deliver(member);
+    }, () => { });
+    return watcher.stop;
+}
+function watchQueue(runtime, locator, deliver) {
+    const { store } = runtime;
+    const watcher = store.watch(queueTopic(locator), deliver);
+    void store.publication(async () => {
+        if (!watcher.held())
+            return;
+        const entries = await entriesOf(runtime, locator);
+        if (watcher.held())
+            watcher.answer(entries);
+    });
+    return watcher.stop;
+}
+function watching(runtime) {
+    const { store, socket, conversations, figures, lastAnswers } = runtime;
+    return (topic, input, deliver, fail) => {
+        const session = socket.session.now();
+        if (topic === 'room-drafts')
+            return watchRoomDrafts(runtime, deliver);
+        if (topic === 'conversation') {
+            return watchConversation(conversations, input[0], input[1], deliver);
+        }
+        if (topic === 'conversations')
+            return watchConversationList(conversations, deliver);
+        if (topic === 'agents')
+            return watchConversationAgents(conversations, deliver);
+        if (topic === 'figures')
+            return figures.watch(deliver, fail);
+        if (topic === 'holdings')
+            return watchHoldings(runtime, deliver, fail);
+        if (topic === 'read')
+            return lastAnswers.watch(input[0], input[1], deliver);
+        if (topic === 'presentation')
+            return watchPresentation(runtime, input[0], deliver);
+        if (topic === 'readiness') {
+            return watchReadiness(runtime, { target: '', code: 'stored' }, null, deliver);
+        }
+        if (topic === 'rooms')
+            return watchRooms(runtime, deliver);
+        if (topic === 'connection-refusal') {
+            return told(store, REFUSAL_TOPIC, deliver, session.refusal);
+        }
+        if (topic === 'storage-loss') {
+            return told(store, STORAGE_LOSS_TOPIC, deliver, store.device.now().storageLoss);
+        }
+        if (topic === 'sync-status') {
+            return told(store, STATUS_TOPIC, deliver, store.device.now().status);
+        }
+        if (topic === 'service-mode') {
+            return told(store, SERVICE_MODE_TOPIC, deliver, session.serviceMode);
+        }
+        if (topic === 'member')
+            return watchMember(runtime, deliver);
+        if (topic === 'authority-changes') {
+            return told(store, AUTHORITY_TOPIC, deliver, session.authorityChanges);
+        }
+        if (topic === 'queue')
+            return watchQueue(runtime, input[0], deliver);
+        return watchPlanned(runtime, planned(runtime, input[0], null), deliver, fail);
+    };
+}
+function roomsOnce(runtime) {
+    const { store, socket } = runtime;
+    if (socket.closed())
+        return Promise.resolve([]);
+    return new Promise((settle) => {
+        const watcher = store.watch(ROOMS_TOPIC, (value) => {
+            watcher.stop();
+            settle(value);
+        });
+        emitKnownRooms(runtime);
+    });
+}
+async function typesOf(runtime, locator) {
+    const { store, builtIn } = runtime;
+    const held = (await store.rooms([locator])).get(locator);
+    const fenced = store.fences.has(locator);
+    const room = fenced ? undefined : declarationOf(runtime, locator, held)?.room;
+    return {
+        collection: modelTypes(fenced ? NO_MODEL : modelIn(runtime, locator, held)),
+        typedSelection: (room?.typedSelection ?? null) === null ? null : modelTypes(builtIn),
+    };
+}
+async function reauthorized(runtime) {
+    const { store, socket, journal } = runtime;
+    const { refusal } = socket.session.now();
+    if (refusal === null || !refusal.reauthorizationOffered)
+        return;
+    journal.record('connection reauthorize');
+    await socket.lanes.current();
+    await store.written();
+    socket.session.set({ authorization: undefined, paused: false });
+    if (!socket.streamed)
+        await sync(runtime, 'unstreamed', null);
+    else
+        await socket.lanes.task(OPENING_LANE, () => socket.authorize());
+}
+function mdRuntime(runtime, watch) {
+    const { store, socket, journal, shell, conversations, lastAnswers } = runtime;
+    return {
+        loaded: () => store.open().then(() => undefined),
+        rooms: () => roomsOnce(runtime),
+        query: ((input) => planned(runtime, input, null).then((plan) => rowsQuery(runtime, plan))),
+        search: (input) => searched(runtime, input, null),
+        types: (locator) => typesOf(runtime, locator),
+        roomDraft: roomDraftSurface(runtime),
+        conversation: conversationSurface(conversations),
+        chatDraft: chatDraftSurface(conversations),
+        presentation: presentationSurface(runtime),
+        save: (room, named, writtenBy) => store.exclusive(() => saveRoomDrafts(runtime, room, named, writtenBy)),
+        saveParts: (room, parts, writtenBy) => store.exclusive(() => saveParts(runtime, room, parts, writtenBy)),
+        history: (locator, path, query) => readHistory(runtime, locator, path, query),
+        resolve: (room, path, destination) => resolveReference(runtime, room, path, destination),
+        binaryFile: binaryFileSurface(runtime),
+        call: (name, input) => called(runtime, name, input),
+        async reached(locator, roomVersion, path) {
+            return path === undefined
+                ? reachedBy(runtime, locator, roomVersion)
+                : writtenAfter(runtime, locator, roomVersion, path);
+        },
+        log: () => journal.export(),
+        async cleanUp() {
+            const freed = await store.ask({ kind: 'opened.clean' });
+            const tidied = (await shell.cleanUp?.()) ?? 0;
+            store.tell(CLEANED_TOPIC, undefined);
+            return freed + tidied;
+        },
+        unsent: () => store.ask({ kind: 'authored.unsent' }),
+        reset: () => shell.reset(),
+        async readAgain() {
+            lastAnswers.again();
+        },
+        persistence: () => store.device.now().persistence === 'granted',
+        async retry() {
+            journal.record('retry');
+            socket.rooms.standAll({ unpreparable: false });
+            store.readiness.queue();
+            if (store.space.full())
+                await store.space.probe();
+        },
+        observe: observing(watch),
+        reauthorize: () => reauthorized(runtime),
+    };
+}
+export function composedRuntime(runtime) {
+    const { store, journal } = runtime;
+    const watch = watching(runtime);
+    const md = mdRuntime(runtime, watch);
+    const reachable = {
+        md,
+        watch,
+        plan: (input, reach) => planned(runtime, input, reach),
+        query: (plan) => rowsQuery(runtime, plan),
+        watchPlan: (plan, deliver, fail) => watchPlan(runtime, plan, deliver, fail),
+        search: (input, reach) => searched(runtime, input, reach),
+        watchReadiness: (port, reach, deliver) => watchReadiness(runtime, port, reach, deliver),
+        locked: (locator) => locked(runtime, locator),
+        lockedRooms: () => lockedRooms(runtime),
+        watchLocks: (notify) => watchLocks(runtime, notify),
+        located: (room, path, destination) => located(runtime, room, path, destination),
+        room: async (locator) => shownRooms(runtime, await listingNow(runtime)).find((one) => one.locator === locator),
+    };
+    return {
+        md,
+        seed: (entry) => keepEntrySeed(store, entry),
+        stop: () => stop(runtime),
+        watch,
+        persisted(answer) {
+            if (answer === store.device.now().persistence)
+                return;
+            store.device.set({ persistence: answer });
+            journal.record(`persistence ${answer}`);
+            store.readiness.queue();
+        },
+        within(reach, port) {
+            if (store.space.full())
+                void store.space.probe();
+            return narrowed(reachable, reach, port);
+        },
+    };
+}

package/dist/sync.d.ts

@@ -0,0 +1,20 @@
+import type { Authorization, AuthorityChange, DiscoveredRoom, Discovery, RoomChange } from './adapter.js';
+import { type Unheld, type Withheld } from './install.js';
+import type { Runtime } from './runtime.js';
+import type { Live } from './socket.js';
+import type { CycleProgress } from './status.js';
+import type { RuntimeStore } from './store.js';
+export type Attempt = 'opened' | 'unstreamed' | 'authorized';
+export declare const OPENING_LANE = "opening";
+export declare function advanced(runtime: Runtime, room: DiscoveredRoom, local: RuntimeStore, authorized: Authorization): Promise<Withheld | null>;
+export declare function withhold(runtime: Runtime, withheld: Withheld, room: DiscoveredRoom, local: RuntimeStore, progress: CycleProgress): Promise<void>;
+export declare function synchronize(runtime: Runtime, listed: readonly DiscoveredRoom[], local: RuntimeStore, progress: CycleProgress, attempt: Attempt, live: Live): Promise<void>;
+export declare function loadRoom(runtime: Runtime, room: DiscoveredRoom, local: RuntimeStore, progress: CycleProgress, live: Live, unheld?: Unheld): Promise<void>;
+export declare function reload(runtime: Runtime, room: DiscoveredRoom, local: RuntimeStore, progress: CycleProgress, live: Live): Promise<void>;
+export declare function finishOpening(runtime: Runtime, progress: CycleProgress, live: Live): Promise<void>;
+export declare function sync(runtime: Runtime, attempt: Attempt, found: Discovery | null): Promise<void>;
+export declare function resynchronize(runtime: Runtime): Promise<void>;
+export declare function countAuthorityChange({ store, socket, lastAnswers }: Runtime): void;
+export declare function changeAuthority(runtime: Runtime, change: AuthorityChange): Promise<void>;
+export declare function applyRoom(runtime: Runtime, change: RoomChange): Promise<void>;
+//# sourceMappingURL=sync.d.ts.map

package/dist/sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync.d.ts","sourceRoot":"","sources":["../src/sync.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,EACb,eAAe,EACf,cAAc,EACd,SAAS,EACT,UAAU,EACX,MAAM,cAAc,CAAC;AAUtB,OAAO,EASL,KAAK,MAAM,EACX,KAAK,QAAQ,EACd,MAAM,cAAc,CAAC;AAOtB,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAE5C,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,KAAK,EAAe,YAAY,EAAE,MAAM,YAAY,CAAC;AAG5D,MAAM,MAAM,OAAO,GAAG,QAAQ,GAAG,YAAY,GAAG,YAAY,CAAC;AAE7D,eAAO,MAAM,YAAY,YAAY,CAAC;AA4FtC,wBAAgB,QAAQ,CACtB,OAAO,EAAE,OAAO,EAChB,IAAI,EAAE,cAAc,EACpB,KAAK,EAAE,YAAY,EACnB,UAAU,EAAE,aAAa,GACxB,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAI1B;AAED,wBAAsB,QAAQ,CAC5B,OAAO,EAAE,OAAO,EAChB,QAAQ,EAAE,QAAQ,EAClB,IAAI,EAAE,cAAc,EACpB,KAAK,EAAE,YAAY,EACnB,QAAQ,EAAE,aAAa,GACtB,OAAO,CAAC,IAAI,CAAC,CA8Bf;AAyDD,wBAAsB,WAAW,CAC/B,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,SAAS,cAAc,EAAE,EACjC,KAAK,EAAE,YAAY,EACnB,QAAQ,EAAE,aAAa,EACvB,OAAO,EAAE,OAAO,EAChB,IAAI,EAAE,IAAI,iBAkCX;AAiBD,wBAAsB,QAAQ,CAC5B,OAAO,EAAE,OAAO,EAChB,IAAI,EAAE,cAAc,EACpB,KAAK,EAAE,YAAY,EACnB,QAAQ,EAAE,aAAa,EACvB,IAAI,EAAE,IAAI,EACV,MAAM,CAAC,EAAE,MAAM,iBAmBhB;AAED,wBAAsB,MAAM,CAC1B,OAAO,EAAE,OAAO,EAChB,IAAI,EAAE,cAAc,EACpB,KAAK,EAAE,YAAY,EACnB,QAAQ,EAAE,aAAa,EACvB,IAAI,EAAE,IAAI,iBA0BX;AAuDD,wBAAsB,aAAa,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,IAAI,EAAE,IAAI,iBAgCxF;AAED,wBAAgB,IAAI,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAsC/F;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAsB7D;AAED,wBAAgB,oBAAoB,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,EAAE,OAAO,QAK3E;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CA6BxF;AAyDD,wBAAgB,SAAS,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAyD7E"}