@agentshouse/mdruntime-families 0.1.0-c8a9a2ed09538 → 0.1.0-c8d38a26efb97

package/dist/mdruntime/actions.d.ts

@@ -0,0 +1,19 @@
+import type { ConversationHistoryRequest } from './adapter.js';
+import { type CallResult, type HistoryAnswer, type Resolution } from './outcome.js';
+import type { Attempted } from './recovery.js';
+import type { Runtime } from './runtime.js';
+export type HistoryQuery = {
+    revision?: string;
+    pageToken?: string;
+};
+export declare function readHistory(runtime: Runtime, locator: string, path: string, query?: HistoryQuery): Promise<HistoryAnswer>;
+export declare function located(runtime: Runtime, room: string, path: string, destination: string): Promise<{
+    room: string;
+    path: string;
+} | null>;
+export declare function resolveReference(runtime: Runtime, room: string, path: string, destination: string): Promise<Resolution>;
+export declare function invokeAction(runtime: Runtime, name: string, input: unknown, dispatching?: () => Promise<void>): Promise<CallResult>;
+export declare function readConversationHistory(runtime: Runtime, request: ConversationHistoryRequest): Promise<CallResult>;
+export declare function called(runtime: Runtime, name: string, input: unknown): Promise<CallResult>;
+export declare function resendCalls(runtime: Runtime, signal: AbortSignal): Promise<Attempted>;
+export declare function resendLater(runtime: Runtime): void;

package/dist/mdruntime/adapter.d.ts

@@ -526,6 +526,7 @@ export type Adapter = {
     readonly nameableRoomTypes?: readonly string[];
     readonly typedPaths?: readonly TypedPath[];
     readonly unkeptReads?: readonly string[];
+    readonly leadingReads?: readonly string[];
     authorize(): Promise<Authorization>;
     discover?(authorization: Authorization): Promise<DiscoverResult>;
     bootstrap(authorization: Authorization, request: BootstrapRequest): Promise<BootstrapResult>;

package/dist/mdruntime/bootstrap.d.ts

@@ -0,0 +1,43 @@
+import type { ModelState } from './model.js';
+import type { Adapter, TypedPath, AdapterFailure, Authorization, BootstrapPart, DiscoveredRoom, NotReady, RetryableRefusal, RoomModels } from './adapter.js';
+import type { Composition } from './collection.js';
+import type { InstallationStep } from './readiness.js';
+import { type Refreshing } from './refresh.js';
+import type { ReplicaRecord } from './replica.js';
+import type { StagedPage, TransferRecord } from './store.js';
+import { type Unconfirmed } from './transfer.js';
+export type Bootstrapped = {
+    kind: 'staged';
+    record: ReplicaRecord;
+    refreshed: boolean;
+};
+export type BootstrapOutcome = Bootstrapped | Unconfirmed | NotReady | RetryableRefusal | AdapterFailure;
+export type HeldModels = {
+    collection: ModelState;
+};
+export type Remodel = (models: RoomModels | undefined, held: HeldModels) => HeldModels;
+export type Reads = Pick<Adapter, 'bootstrap' | 'refresh' | 'reached'>;
+export type Arriving = {
+    at(bytes: number): void;
+    end(): void;
+};
+export type Resumed = {
+    readonly record: TransferRecord | null;
+    readonly staged: ReadonlySet<string>;
+};
+export type Staging = {
+    held(locator: string): TransferRecord | null;
+    turn(locator: string, step: InstallationStep): Promise<() => void>;
+    unqueued(): Promise<void>;
+    queued(text: number): () => void;
+    arriving(locator: string): Arriving;
+    readonly streamed: boolean;
+    stage(record: TransferRecord, page: StagedPage, composition: Composition): Promise<TransferRecord | null>;
+    resume(record: TransferRecord, parts: readonly BootstrapPart[], composition: Composition): Promise<Resumed | null>;
+    derive(locator: string, key: number, composition: Composition): Promise<boolean>;
+    refreshing(locator: string, key: number, composition: Composition): Promise<Refreshing>;
+    abandon(locator: string): Promise<void>;
+    setAside(locator: string): Promise<void>;
+    release(key: number): Promise<void>;
+};
+export declare function bootstrapRoom(adapter: Reads, authorization: Authorization, room: DiscoveredRoom, held: HeldModels, builtIn: ModelState, typedPaths: readonly TypedPath[], remodel: Remodel, continuing: () => boolean, staging: Staging): Promise<BootstrapOutcome>;

package/dist/mdruntime/cell.d.ts

@@ -0,0 +1,5 @@
+export type Cell<T> = {
+    now(): T;
+    set(change: Partial<T>): void;
+};
+export declare function createCell<T extends object>(first: T): Cell<T>;

package/dist/mdruntime/client.d.ts

@@ -1,11 +1,16 @@
 import type { DocumentQuery, GroupQuery } from '@agentshouse/mdmodel';
-import type { AppRoom, ConnectionRefusal, HistoryQuery, RoomSchemas, SavedParts, SavedRoomDraft, SaveResult } from './connection.js';
+import type { HistoryQuery } from './actions.js';
+import type { AppRoom } from './listing.js';
+import type { ConnectionRefusal } from './socket.js';
+import type { RoomSchemas } from './surface.js';
+import type { SavedParts, SavedRoomDraft, SaveResult } from './saves.js';
 import type { Member, ServiceMode } from './adapter.js';
 import type { UnsentWork } from './durability.js';
 import type { ChatDraft, ConversationAgent, ConversationAnswer, ConversationEntry, ConversationOptions, ConversationRead, ConversationView } from './conversation.js';
 import { type Observation } from './observation.js';
 import type { AttachAnswer, BinaryAnswer, CallResult, DownloadAnswer, HistoryAnswer, Offline, QueueEntry, Resolution } from './outcome.js';
 import type { FiguresResult } from './figures.js';
+import type { Holdings } from './holdings.js';
 import type { DocumentResult, GroupResult, PendingResult } from './query.js';
 import type { RoomDraft, RoomDraftParts, RoomDraftWrite } from './room-draft.js';
 import type { SearchRequest, SearchResult } from './search.js';
@@ -84,6 +89,7 @@ export type MdRuntimeClient = {
         (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>;

package/dist/mdruntime/conversation.d.ts

@@ -12,6 +12,7 @@ export type ConversationEntry = ConversationHeld & {
     agent: {
         identity: string;
         name: string;
+        retired: boolean;
     };
     name: string;
     created: string;

package/dist/mdruntime/durability.d.ts

@@ -4,12 +4,21 @@ export type UnsentWork = {
     readonly kind: UnsentKind;
     readonly count: number;
 };
+export type AppCode = {
+    readonly running: number;
+    readonly older: number;
+};
+export type HeldCode = {
+    readonly house: number | null;
+    readonly apps: readonly string[];
+};
 export type RuntimeShell = {
     persistence: Persistence;
     generation: string | null;
     keepGeneration(value: string): void | Promise<void>;
     dropGeneration(): void | Promise<void>;
     cleanUp?(): Promise<number>;
+    measure?(measured: (app: string, code: AppCode | null) => void): Promise<HeldCode>;
     reset(): Promise<void>;
 };
 export declare function refusedForSpace(error: unknown): boolean;

package/dist/mdruntime/holdings.d.ts

@@ -0,0 +1,28 @@
+import type { AppCode } from './durability.js';
+import type { GroupTotal, PendingResult } from './query.js';
+import type { Deliver, Fail } from './reach.js';
+import type { Runtime } from './runtime.js';
+import type { OpenedRoom } from './tables.js';
+export type RoomDocuments = {
+    readonly room: string;
+    readonly documents: GroupTotal;
+};
+export type HeldApp = ({
+    readonly app: string;
+    readonly state: 'measured';
+} & AppCode) | {
+    readonly app: string;
+    readonly state: 'asking' | 'unknown';
+};
+export type Holdings = {
+    readonly rooms: readonly RoomDocuments[] | PendingResult;
+    readonly opened: GroupTotal & {
+        readonly rooms: readonly OpenedRoom[];
+    };
+    readonly apps: readonly HeldApp[];
+    readonly house: number | null;
+    readonly total: number | null;
+    readonly cleanUp: number | null;
+};
+export declare const CLEANED_TOPIC = "cleaned";
+export declare function watchHoldings({ store, figures, shell }: Runtime, deliver: Deliver, fail: Fail): () => void;

package/dist/mdruntime/install.d.ts

@@ -0,0 +1,55 @@
+import type { AdapterFailure, Authorization, DiscoveredRoom, NotReady, RetryableRefusal } from './adapter.js';
+import { type Reads } from './bootstrap.js';
+import type { Installation, RoomCoverage } from './readiness.js';
+import { advancement, type Refresher } from './refresh.js';
+import type { ReplicaRecord } from './replica.js';
+import type { Runtime } from './runtime.js';
+import type { Live } from './socket.js';
+import { type CoveredRoom, type InstallHold, type RuntimeStore, type Store } from './store.js';
+import { type Unconfirmed } from './transfer.js';
+type Standing = {
+    readonly key: number | null;
+    readonly confirmed: number;
+};
+export type Unheld = {
+    readonly staged: boolean;
+};
+export type Withheld = AdapterFailure | RetryableRefusal | NotReady | Unconfirmed;
+type Landing = {
+    readonly kind: 'refreshed';
+    readonly from: Standing;
+    readonly remodelled: boolean;
+} | {
+    readonly kind: 'bootstrapped';
+    readonly refreshed: boolean;
+    readonly from: Standing;
+};
+type Refreshed = {
+    kind: 'advanced';
+    record: ReplicaRecord;
+    from: Standing;
+    remodelled: boolean;
+} | Exclude<Awaited<ReturnType<typeof advancement>>, {
+    kind: 'advanced';
+}>;
+export declare const ERASE_BATCH = 512;
+export declare function installationOf(store: Store, coverage: readonly RoomCoverage[], held: ReadonlyMap<string, CoveredRoom>): Installation;
+export declare function roomInFlight(store: Store, locator: string): boolean;
+export declare function sweep({ store, socket, journal }: Runtime): void;
+export declare function forgetInstall(store: Store, locator: string): void;
+export declare function caughtUpTo(runtime: Runtime, locator: string): void;
+export declare function catching(store: Store, locator: string): void;
+export declare function confirmedAgain(store: Store, locator: string): void;
+export declare function standingAt(store: Store, locator: string, held: Pick<ReplicaRecord, 'key'> | undefined): Standing;
+export declare function showing(system: Runtime, locator: string, roomVersion: string, held: string | undefined): void;
+export declare function olderThan(system: Runtime, locator: string, roomVersion: string, held: string | undefined): boolean;
+export declare function replaced(store: Store, locators: readonly string[]): void;
+export declare function reachedBy({ store, socket }: Runtime, locator: string, roomVersion: string): Promise<boolean>;
+export declare function behind({ store, socket }: Runtime, room: DiscoveredRoom): Promise<boolean>;
+export declare function writtenAfter({ store, socket }: Runtime, locator: string, roomVersion: string, path: string): Promise<boolean>;
+export declare function pullRefresh(runtime: Runtime, authorized: Authorization, record: ReplicaRecord, liveness: Live, hold: InstallHold, refresh: Refresher): Promise<Refreshed>;
+export declare function pullBootstrap(runtime: Runtime, authorized: Authorization, room: DiscoveredRoom, local: RuntimeStore, liveness: Live, prior: ReplicaRecord | undefined, from?: Reads, unheld?: Unheld): Promise<import("./bootstrap.js").Bootstrapped | NotReady | import("./adapter.js").RevokedAuthorization | import("./adapter.js").RoomNotReadable | Unconfirmed | {
+    readonly kind: 'transport-uncertainty';
+} | RetryableRefusal | import("./adapter.js").ScopedRefusal>;
+export declare function publish(runtime: Runtime, local: RuntimeStore, room: DiscoveredRoom, reached: ReplicaRecord, landing: Landing, live: Live): Promise<boolean>;
+export {};

package/dist/mdruntime/listing.d.ts

@@ -0,0 +1,52 @@
+import type { HeldRooms } from '@agentshouse/mdmodel';
+import type { DiscoveredRoom, HeldRoom, OperationScopes, ProviderRefusal, ReplicaAdmission } from './adapter.js';
+import type { Composition } from './collection.js';
+import { type ModelState, type TypesResult } from './model.js';
+import { type PortReach } from './reach.js';
+import type { ReplicaRecord } from './replica.js';
+import type { Runtime } from './runtime.js';
+import type { RoomDeclaration } from './socket.js';
+import type { Stored } from './store.js';
+export type AppTypedSelection = {
+    roots: readonly string[];
+    model: TypesResult;
+};
+export type AppRoom = {
+    name: string;
+    locator: string;
+    handle: string;
+    operations: OperationScopes;
+    replica: ReplicaAdmission;
+    model: TypesResult;
+    typedSelection: AppTypedSelection | null;
+    providerOwnedPaths: readonly string[];
+    roomVersion: string | null;
+    documents: number;
+    synchronizationAvailable: boolean;
+    refusal: ProviderRefusal | null;
+    locked: boolean;
+};
+type ListedRoom = Omit<AppRoom, 'documents' | 'locked'>;
+type ListedEntry = ListedRoom & {
+    readonly documents: number;
+};
+export type Listing = ReadonlyMap<string, ListedEntry>;
+export declare function modelIn({ socket }: Runtime, locator: string, stored: Stored | undefined): ModelState;
+export declare function compositionFor(runtime: Runtime, record: ReplicaRecord): Composition;
+export declare function declarationOf({ socket }: Runtime, locator: string, stored: Stored | undefined): {
+    readonly room: RoomDeclaration;
+    readonly available: boolean;
+} | undefined;
+export declare function listedLocators({ store, socket }: Runtime, held: ReadonlyMap<string, unknown>): string[];
+export declare function patchedListing(runtime: Runtime, changed: ReadonlySet<string>): Promise<Listing | null>;
+export declare function listingNow(runtime: Runtime): Promise<Listing>;
+export declare function shownRooms(runtime: Runtime, listing: Listing): readonly AppRoom[];
+export declare function roomFacts(runtime: Runtime, reach?: PortReach | null): Promise<HeldRooms>;
+export declare function list({ store, socket }: Runtime, room: RoomDeclaration, synchronizationAvailable: boolean): void;
+export declare function listHeld({ store, socket }: Runtime, locator: string): void;
+export declare function admitted({ socket }: Runtime, room: RoomDeclaration): boolean;
+export declare function readable(runtime: Runtime, room: DiscoveredRoom): void;
+export declare function usable(runtime: Runtime, room: DiscoveredRoom): void;
+export declare function heldRooms({ store }: Runtime, listed: readonly DiscoveredRoom[]): Promise<HeldRoom[]>;
+export declare function name(runtime: Runtime, locator: string): Promise<void>;
+export {};

package/dist/mdruntime/log.d.ts

@@ -0,0 +1,5 @@
+export declare function createLog(): {
+    record(event: string): void;
+    export(): string;
+};
+export type Log = ReturnType<typeof createLog>;

package/dist/mdruntime/preparation.d.ts

@@ -0,0 +1,19 @@
+import type { PlanReach } from './query.js';
+import { type PortReach } from './reach.js';
+import { type CodeAvailability, type ConnectionAvailability, type Readiness } from './readiness.js';
+import type { Runtime } from './runtime.js';
+export type ReadinessPort = {
+    readonly target: string;
+    readonly code: CodeAvailability;
+};
+export type ReadinessWatch = {
+    readonly port: ReadinessPort;
+    readonly reach: PortReach | null;
+    readonly deliver: (readiness: Readiness) => void;
+};
+export declare function prepare(runtime: Runtime, locators?: readonly string[]): void;
+export declare function roomsOfReach(reach: PlanReach): ReadonlySet<string>;
+export declare function connectionNow(runtime: Runtime): Promise<ConnectionAvailability>;
+export declare function deliverOwedReadiness(runtime: Runtime, owed: readonly ReadinessWatch[]): Promise<void>;
+export declare function watchReadiness({ store }: Runtime, port: ReadinessPort, reach: PortReach | null, deliver: (readiness: Readiness) => void): () => void;
+export declare function filled(runtime: Runtime): void;

package/dist/mdruntime/reach.d.ts

@@ -1,4 +1,6 @@
-import type { AppRoom, MdRuntime, ReadinessPort, RuntimeTopic } from './connection.js';
+import type { AppRoom } from './listing.js';
+import type { ReadinessPort } from './preparation.js';
+import type { MdRuntime, RuntimeTopic } from './surface.js';
 import type { Plan, PlanReach, QueryResult } from './query.js';
 import type { Readiness } from './readiness.js';
 import type { SearchResult } from './search.js';

package/dist/mdruntime/reads.d.ts

@@ -21,6 +21,7 @@ export type ReadAnswersOptions = {
     readonly database: RuntimeDatabase;
     readonly build: string;
     readonly unkept: readonly string[];
+    readonly leading: readonly string[];
     readonly recovery: Recovery;
     call(name: string, input: unknown): Promise<CallResult>;
     online(): boolean;

package/dist/mdruntime/refresh.d.ts

@@ -0,0 +1,26 @@
+import type { AdapterFailure, Authorization, RefreshPage, RefreshRequest, RefreshResult, RetryableRefusal } from './adapter.js';
+import type { Remodel } from './bootstrap.js';
+import type { ReplicaRecord } from './replica.js';
+import type { RefreshedPage } from './store.js';
+import type { HeldEntry, StoredEntry } from './tables.js';
+import { type Unconfirmed } from './transfer.js';
+export type Advancement = {
+    kind: 'still-current';
+} | {
+    kind: 'advanced';
+    record: ReplicaRecord;
+    changed: ReadonlySet<string>;
+} | {
+    kind: 'beyond-horizon';
+} | RetryableRefusal | Unconfirmed | AdapterFailure;
+export type Refresher = (authorization: Authorization, request: RefreshRequest) => Promise<RefreshResult>;
+export type Refreshing = {
+    turn(): void;
+    prior(paths: readonly string[]): Promise<ReadonlyMap<string, HeldEntry>>;
+    later(paths: readonly string[], roomVersion: string): Promise<ReadonlySet<string>>;
+    stage(page: RefreshedPage): Promise<boolean>;
+};
+type PageContent = Pick<RefreshPage, 'documents' | 'facts' | 'revisions' | 'fileIds' | 'created' | 'changes' | 'binaryFiles'>;
+export declare function pageEntries(page: PageContent, removals: readonly string[], roomVersion: string, prior: (paths: readonly string[]) => Promise<ReadonlyMap<string, HeldEntry>>): Promise<StoredEntry[]>;
+export declare function advancement(refresh: Refresher, authorization: Authorization, held: ReplicaRecord, remodel: Remodel, continuing: () => boolean, staging: Refreshing): Promise<Advancement>;
+export {};

package/dist/mdruntime/room-drafts.d.ts

@@ -1,13 +1,8 @@
 import { type ChangeSet } from './change-set.js';
 import { type VisibleLayer } from './replica.js';
 import { type RoomDraft, type RoomDraftWrite } from './room-draft.js';
+import type { Runtime } from './runtime.js';
 import type { Store } from './store.js';
-export type RoomDrafting = {
-    readonly store: Store;
-    closed(): boolean;
-    publishChangeSet(set: ChangeSet): Promise<void>;
-    statusShown(): Promise<void>;
-};
 export type RoomDraftSurface = {
     list(): Promise<readonly RoomDraft[]>;
     read(room: string, path: string): Promise<RoomDraft | null>;
@@ -20,9 +15,9 @@ export type PresentationSurface = {
     edit(app: string, members: Readonly<Record<string, unknown>>): Promise<void>;
 };
 export declare function visibleOf(store: Store, locator: string, paths: readonly string[]): Promise<VisibleLayer | undefined>;
-export declare function publishRoomDrafts({ store, closed }: RoomDrafting, waitingOnly: boolean, touched?: ChangeSet['documents'] | null): Promise<void>;
-export declare function emitPresentation({ store, closed }: RoomDrafting, app: string): Promise<void>;
-export declare function roomDraftSurface(drafting: RoomDrafting): RoomDraftSurface;
-export declare function presentationSurface(drafting: RoomDrafting): PresentationSurface;
-export declare function watchRoomDrafts({ store, closed }: RoomDrafting, deliver: (value: unknown) => void): () => void;
-export declare function watchPresentation({ store, closed }: RoomDrafting, app: string, deliver: (value: unknown) => void): () => void;
+export declare function publishRoomDrafts({ store, socket }: Runtime, waitingOnly: boolean, touched?: ChangeSet['documents'] | null): Promise<void>;
+export declare function emitPresentation({ store, socket }: Runtime, app: string): Promise<void>;
+export declare function roomDraftSurface(runtime: Runtime): RoomDraftSurface;
+export declare function presentationSurface(runtime: Runtime): PresentationSurface;
+export declare function watchRoomDrafts({ store, socket }: Runtime, deliver: (value: unknown) => void): () => void;
+export declare function watchPresentation({ store, socket }: Runtime, app: string, deliver: (value: unknown) => void): () => void;

package/dist/mdruntime/runtime.d.ts

@@ -0,0 +1,41 @@
+import type { Authorization, DiscoveredRoom, ScopedRefusal, TypedPath } from './adapter.js';
+import type { ChangeSet } from './change-set.js';
+import type { ChangeBatch } from './change.js';
+import type { RuntimeShell } from './durability.js';
+import type { ConversationStore } from './conversation.js';
+import type { FiguresRead } from './figures.js';
+import type { Withheld } from './install.js';
+import type { LiveQueries } from './live.js';
+import type { Log } from './log.js';
+import type { ModelState } from './model.js';
+import type { ReadAnswers } from './reads.js';
+import type { Recovery } from './recovery.js';
+import type { ReplicaRecord } from './replica.js';
+import type { RuntimeSocket, RoomDeclaration } from './socket.js';
+import type { CycleProgress } from './status.js';
+import type { Settling } from './saves.js';
+import type { HeldCover, RuntimeStore, Store, Work } from './store.js';
+import type { schemaTypes } from './attached-model.js';
+export type Runtime = {
+    readonly store: Store;
+    readonly socket: RuntimeSocket;
+    readonly journal: Log;
+    readonly recovery: Recovery;
+    readonly shell: RuntimeShell;
+    readonly localSaves: boolean;
+    readonly roomTypes: Parameters<typeof schemaTypes>[1];
+    readonly builtIn: ModelState;
+    readonly typedPaths: readonly TypedPath[];
+    readonly usableWhenHeld: readonly string[];
+    readonly build: string;
+    readonly conversations: ConversationStore;
+    readonly liveQueries: LiveQueries<HeldCover>;
+    readonly figures: FiguresRead;
+    readonly lastAnswers: ReadAnswers;
+    settle(local: RuntimeStore, locator: string, work: Work, record: ReplicaRecord, queue: readonly ChangeBatch[], settling?: Settling): Promise<ChangeSet>;
+    scoped(result: ScopedRefusal, room: RoomDeclaration, local: RuntimeStore): Promise<void>;
+    submitLater(locator: string): void;
+    unpair(local: RuntimeStore): Promise<void>;
+    advanced(room: DiscoveredRoom, local: RuntimeStore, authorized: Authorization): Promise<Withheld | null>;
+    withhold(withheld: Withheld, room: DiscoveredRoom, local: RuntimeStore, progress: CycleProgress): Promise<void>;
+};

package/dist/mdruntime/saves.d.ts

@@ -0,0 +1,69 @@
+import { type ChangeSet } from './change-set.js';
+import { type ChangeBatch, type WrittenBy } from './change.js';
+import { type AttachAnswer, type BinaryLinkAnswer, type HeldBinaryAnswer, type HeldShownAnswer } from './outcome.js';
+import { type HeldReplica, type ReplicaRecord, type Slice, type VisibleLayer } from './replica.js';
+import { type ReturnReason, type RoomDraftParts } from './room-draft.js';
+import type { Runtime } from './runtime.js';
+import { type SaveRefusal } from './save.js';
+import type { AuthoredWrite, CommittedWrite, PendingState, RoomCommit, RuntimeStore, Store, StoredEntry, View, Work } from './store.js';
+export type SaveResult = {
+    outcome: 'saved';
+    identifier: string;
+} | ({
+    outcome: 'refused';
+} & SaveRefusal);
+export type SavedRoomDraft = {
+    readonly path: string;
+    readonly revision: string;
+};
+export type SavedParts = {
+    readonly path: string;
+    readonly parts: RoomDraftParts;
+};
+export type BinaryFileSurface = {
+    read(room: string, path: string, revision?: string): Promise<HeldBinaryAnswer>;
+    link(room: string, path: string, revision?: string): Promise<BinaryLinkAnswer>;
+    show(room: string, path: string, revision?: string): Promise<HeldShownAnswer>;
+    attach(room: string, file: File): Promise<AttachAnswer>;
+    part(file: string, part: number): Promise<Uint8Array | null>;
+};
+export type Leaving = {
+    batch: ChangeBatch;
+    returned: ReturnReason | null;
+};
+export declare function withdrawable(states: ReadonlyMap<string, PendingState>): (batch: ChangeBatch) => boolean;
+export declare function sliceAt(store: Store, record: ReplicaRecord, view: View, queue: readonly ChangeBatch[], extra?: Iterable<string>, moved?: Iterable<string>): Promise<Slice>;
+export declare function landedWhole(store: Store, locator: string, batch: ChangeBatch, confirmedLayer: Slice, current?: Readonly<Record<string, string>>): Promise<boolean>;
+export type Settling = {
+    leaving?: readonly Leaving[];
+    room?: boolean;
+    view?: View;
+    commit?: Pick<RoomCommit, 'published' | 'refreshed'>;
+    changes?: {
+        readonly set: readonly StoredEntry[];
+        readonly removed: readonly string[];
+    };
+};
+export declare function preparedAfter(runtime: Runtime, locator: string, answer: CommittedWrite): void;
+export declare function replayed(store: Store, record: ReplicaRecord, confirmedLayer: Slice, queue: readonly ChangeBatch[]): import("./turn.js").Later<import("./replica.js").Replayed>;
+export declare function overlayDiff(record: ReplicaRecord, before: HeldReplica | undefined, visible: VisibleLayer, touched: ReadonlySet<string>): Promise<{
+    overlay: NonNullable<RoomCommit['overlay']>;
+    touched: ReadonlySet<string>;
+}>;
+export type Settlement = {
+    readonly locator: string;
+    readonly left: readonly ChangeBatch[];
+    readonly commit: {
+        readonly rooms: readonly RoomCommit[];
+        readonly writes: readonly AuthoredWrite[];
+    };
+    apply(answer: CommittedWrite): ChangeSet;
+};
+export declare function settle(runtime: Runtime, local: RuntimeStore, locator: string, work: Work, record: ReplicaRecord, queue: readonly ChangeBatch[], settling?: Settling): Promise<ChangeSet>;
+export declare function together(runtime: Runtime, local: RuntimeStore, settlements: readonly Settlement[]): Promise<ChangeSet>;
+export declare function settlement(runtime: Runtime, local: RuntimeStore, locator: string, work: Work, record: ReplicaRecord, queue: readonly ChangeBatch[], settling?: Settling): Promise<Settlement>;
+export declare function unpairing(runtime: Runtime, local: RuntimeStore, locator: string, batches: readonly ChangeBatch[]): Promise<Settlement>;
+export declare function saveRoomDrafts(runtime: Runtime, locator: string, named: readonly SavedRoomDraft[], writtenBy: WrittenBy | undefined): Promise<SaveResult>;
+export declare function saveParts(runtime: Runtime, locator: string, named: readonly SavedParts[], writtenBy: WrittenBy | undefined): Promise<SaveResult>;
+export declare function batchFile(store: Store, batch: ChangeBatch): (localId: string) => Promise<Blob>;
+export declare function binaryFileSurface(runtime: Runtime): BinaryFileSurface;

package/dist/mdruntime/seed.d.ts

@@ -2,6 +2,7 @@ import type { Cover } from './live.js';
 import { type KeyedResult } from './observation.js';
 import type { Plan, QueryRows } from './query.js';
 import type { Deliver } from './reach.js';
+import type { Runtime } from './runtime.js';
 import type { HeldCover, Store } from './store.js';
 export type EntrySeed = {
     readonly at: Readonly<Record<string, string>>;
@@ -14,16 +15,10 @@ export type Seeded = {
     readonly rows: QueryRows;
     readonly at: Readonly<Record<string, string>>;
 };
-export type Seeding = {
-    readonly store: Store;
-    reached(room: string, version: string, target: string): boolean;
-    listed(): boolean;
-    declares(room: string): boolean;
-};
 type SeededWatch = (coverOf: (cover: Cover, held: HeldCover) => Cover, deliver: (message: unknown) => void) => () => void;
 export declare function entrySeedOf(value: unknown): EntrySeed | null;
 export declare function seededResult(seed: Seeded): KeyedResult;
-export declare function seedApplies(seeding: Seeding, plan: Plan, held: HeldCover): Seeded | null;
+export declare function seedApplies(runtime: Runtime, plan: Plan, held: HeldCover): Seeded | null;
 export declare function keepEntrySeed(store: Store, entry: EntrySeed): void;
-export declare function watchSeeded(seeding: Seeding, plan: Plan, deliver: Deliver, watch: SeededWatch): () => void;
+export declare function watchSeeded(runtime: Runtime, plan: Plan, deliver: Deliver, watch: SeededWatch): () => void;
 export {};

package/dist/mdruntime/socket/admission.d.ts

@@ -0,0 +1,6 @@
+export type Admission = {
+    heldStream(): Promise<() => void>;
+    unqueued(): Promise<void>;
+    queued(text: number): () => void;
+};
+export declare function createAdmission(): Admission;

package/dist/mdruntime/socket/answers.d.ts

@@ -0,0 +1,5 @@
+export type Answers = {
+    awaitingAnswer(locator: string): () => void;
+    answered(locator: string): Promise<void> | undefined;
+};
+export declare function createAnswers(): Answers;

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

@@ -0,0 +1,19 @@
+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 {};

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

@@ -0,0 +1,42 @@
+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;

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

@@ -0,0 +1,38 @@
+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>;

package/dist/mdruntime/socket.d.ts

@@ -0,0 +1,69 @@
+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;

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

@@ -0,0 +1,9 @@
+export type ReadinessQueue<W> = {
+    add(watch: W): () => void;
+    held(watch: W): boolean;
+    changed(watch: W, reading: string): boolean;
+    owe(watches: readonly W[]): void;
+    queue(): void;
+    close(): void;
+};
+export declare function createReadinessQueue<W>(deliver: (owed: readonly W[]) => Promise<void>, unpublished: (error: unknown) => void): ReadinessQueue<W>;

package/dist/mdruntime/store/room-held.d.ts

@@ -0,0 +1,7 @@
+export type RoomHeld<T> = {
+    of(locator: string, key: string): T | undefined;
+    hold(locator: string, key: string, value: T): void;
+    drop(locator: string, key: string): void;
+    forget(locator: string): void;
+};
+export declare function createRoomHeld<T>(): RoomHeld<T>;

package/dist/mdruntime/store/space.d.ts

@@ -0,0 +1,10 @@
+import type { RuntimeDatabase } from '../tables.js';
+export type Space = {
+    full(): boolean;
+    fill(): boolean;
+    probing(): boolean;
+    probeEachMinute(): void;
+    probe(): Promise<boolean>;
+    stop(): void;
+};
+export declare function createSpace(database: RuntimeDatabase, freed: () => void): Space;

package/dist/mdruntime/store/watchers.d.ts

@@ -6,8 +6,10 @@ export type Watcher = {
 export type Watching = 'all' | 'waiting' | 'ready';
 type Watchers = {
     publication(work: () => Promise<void>): Promise<void>;
+    owing<T>(topic: string, add: (owed: T | undefined) => T, work: (owed: T) => Promise<void>): Promise<void>;
     watch(topic: string, notify: (value: unknown) => void): Watcher;
     watching(topic: string, which?: Watching): readonly Watcher[];
+    tell(topic: string, value: unknown): void;
     close(): void;
 };
 export declare function createWatchers(unpublished: (error: unknown) => void): Watchers;

package/dist/mdruntime/store.d.ts

@@ -1,15 +1,25 @@
 import type { TypedPath } from './adapter.js';
 import { schemaTypes } from './attached-model.js';
+import { type Cell } from './cell.js';
 import type { ChangeBatch } from './change.js';
+import type { ChangeSet } from './change-set.js';
 import type { Composition } from './collection.js';
+import type { ReadinessWatch } from './preparation.js';
+import type { Persistence } from './readiness.js';
+import type { Listing } from './listing.js';
 import type { Seeded } from './seed.js';
 import type { ModelState } from './model.js';
+import { type OpenedFiles } from './opened.js';
 import { type HeldReplica, type ReplicaRecord } from './replica.js';
 import type { RoomDraftRecord } from './room-draft.js';
+import { type SyncStatus } from './status.js';
 import type { RuntimeDatabase } from './tables.js';
 import { type Fences } from './store/fences.js';
 import { type Installs } from './store/installs.js';
 import { type HeldCover, type PendingState, type RuntimeStore } from './store/records.js';
+import { type ReadinessQueue } from './store/readiness.js';
+import { type RoomHeld } from './store/room-held.js';
+import { type Space } from './store/space.js';
 import { type Watcher, type Watching } from './store/watchers.js';
 import { createWrites, type InstallHold } from './store/writes.js';
 export { NO_INSTALL, type RoomInstall } from './store/installs.js';
@@ -29,20 +39,45 @@ export type Work = {
     readonly queue: readonly ChangeBatch[];
     readonly states: ReadonlyMap<string, PendingState>;
 };
+type LandedAhead = Readonly<Record<string, string | undefined>>;
+type AttachedFile = {
+    readonly revision: string;
+    readonly mediaType: string;
+};
 type Seeds = {
     of(key: string): Seeded | undefined;
     keep(key: string, seed: Seeded): void;
     drop(key: string): void;
 };
+export type Device = {
+    readonly persistence: Persistence;
+    readonly storageLoss: string | null;
+    readonly heldWhenOpened: boolean;
+    readonly preparing: boolean;
+    readonly sweeping: boolean;
+    readonly unpreparedDemand: ReadonlySet<string>;
+    readonly establishing: ReadonlySet<string>;
+    readonly status: SyncStatus;
+    readonly roomsShown: Listing | null;
+};
 type StoreOptions = {
     readonly database: RuntimeDatabase;
     readonly roomTypes: Parameters<typeof schemaTypes>[1];
     readonly builtIn: ModelState;
     readonly typedPaths: readonly TypedPath[];
+    readonly persistence: Persistence;
     opening(records: RuntimeStore): Promise<RuntimeStore>;
     unpublished(error: unknown): void;
+    changed(set: ChangeSet): Promise<void>;
+    deliverReadiness(owed: readonly ReadinessWatch[]): Promise<void>;
+    spaceFreed(): void;
 };
 export type Store = {
+    readonly device: Cell<Device>;
+    readonly space: Space;
+    readonly readiness: ReadinessQueue<ReadinessWatch>;
+    ask: RuntimeDatabase['ask'];
+    changed(set: ChangeSet): Promise<void>;
     open(): Promise<RuntimeStore>;
     durably<T>(work: (local: RuntimeStore) => Promise<T>): Promise<T>;
     exclusive<T>(work: () => Promise<T>): Promise<T>;
@@ -64,11 +99,17 @@ export type Store = {
     draft(locator: string, path: string): Promise<RoomDraftRecord | undefined>;
     composed(record: Pick<ReplicaRecord, 'model' | 'typedSelection'>): Composition;
     publication(work: () => Promise<void>): Promise<void>;
+    owing<T>(topic: string, add: (owed: T | undefined) => T, work: (owed: T) => Promise<void>): Promise<void>;
     watch(topic: string, notify: (value: unknown) => void): Watcher;
     watching(topic: string, which?: Watching): readonly Watcher[];
+    tell(topic: string, value: unknown): void;
     readonly fences: Fences;
     readonly installs: Installs;
     readonly seeds: Seeds;
+    readonly landed: RoomHeld<LandedAhead>;
+    readonly attached: RoomHeld<AttachedFile>;
+    readonly opened: OpenedFiles;
+    part(file: string, part: number): Promise<Uint8Array | null>;
     forget(locator: string): void;
     close(): void;
 };

package/dist/mdruntime/{connection.d.ts → surface.d.ts}

@@ -1,91 +1,32 @@
-import { type DocumentQuery, type GroupQuery } from '@agentshouse/mdmodel';
+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, ConversationEntry, ConversationAgent, ConversationOptions, ConversationSurface, 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 DocumentResult, type GroupResult, type PendingResult } from './query.js';
-import { type FiguresResult } from './figures.js';
-import { type EntrySeed } from './seed.js';
-import { type SearchRequest, type SearchResult } from './search.js';
-import { type Adapter, type Authorization, type Member, type ProviderRefusal, type ServiceMode } from './adapter.js';
-import { type ChatDraftSurface, type ConversationAgent, type ConversationEntry, type ConversationOptions, type ConversationSurface, type ConversationView } from './conversation.js';
-import { type WrittenBy } from './change.js';
-import type { Open } from './open.js';
-import { type AttachAnswer, type BinaryLinkAnswer, type CallResult, type HeldBinaryAnswer, type HeldShownAnswer, type HistoryAnswer, type QueueEntry, type Resolution } from './outcome.js';
-import { type ObservedRead } from './reads.js';
-import { type Recovery } from './recovery.js';
-import { type SaveRefusal } from './save.js';
-import { type RoomDraft, type RoomDraftParts } from './room-draft.js';
-import { type SyncStatus } from './status.js';
-import { type RuntimeShell, type UnsentWork } from './durability.js';
-import { type CodeAvailability, type Persistence, type Readiness } from './readiness.js';
-import { type RuntimeDatabase } from './store.js';
-import { type PresentationSurface, type RoomDraftSurface } from './room-drafts.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';
-export type AppTypedSelection = {
-    roots: readonly string[];
-    model: TypesResult;
-};
-export type AppRoom = {
-    name: string;
-    locator: string;
-    handle: string;
-    operations: import('./adapter.js').OperationScopes;
-    replica: import('./adapter.js').ReplicaAdmission;
-    model: TypesResult;
-    typedSelection: AppTypedSelection | null;
-    providerOwnedPaths: readonly string[];
-    roomVersion: string | null;
-    documents: number;
-    synchronizationAvailable: boolean;
-    refusal: ProviderRefusal | null;
-    locked: boolean;
-};
+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;
 };
-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 MdRuntimeOptions = {
-    adapter: Adapter;
-    shell: RuntimeShell;
-    database: RuntimeDatabase;
-    authorization?: Authorization;
-    signal?: AbortSignal;
-    recovery?: Recovery;
-    usableWhenHeld?: readonly string[];
-    build?: string;
-};
-export type SaveResult = {
-    outcome: 'saved';
-    identifier: string;
-} | ({
-    outcome: 'refused';
-} & SaveRefusal);
-export type SavedRoomDraft = {
-    readonly path: string;
-    readonly revision: string;
-};
-export type SavedParts = {
-    readonly path: string;
-    readonly parts: RoomDraftParts;
-};
-export type BinaryFileSurface = {
-    read(room: string, path: string, revision?: string): Promise<HeldBinaryAnswer>;
-    link(room: string, path: string, revision?: string): Promise<BinaryLinkAnswer>;
-    show(room: string, path: string, revision?: string): Promise<HeldShownAnswer>;
-    attach(room: string, file: File): Promise<AttachAnswer>;
-    part(file: string, part: number): Promise<Uint8Array | null>;
-};
-export type HistoryQuery = {
-    revision?: string;
-    pageToken?: string;
-};
 export type MdRuntime = {
     loaded(): Promise<void>;
     rooms(): Promise<readonly AppRoom[]>;
@@ -131,20 +72,16 @@ export type MdRuntime = {
         (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' | 'read';
-export type ReadinessPort = {
-    readonly target: string;
-    readonly code: CodeAvailability;
-};
+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 composeRuntime(options: MdRuntimeOptions): ComposedRuntime;
-export {};
+export declare function composedRuntime(runtime: Runtime): ComposedRuntime;

package/dist/mdruntime/tables.d.ts

@@ -3,7 +3,7 @@ import type { Composed } from './collection.js';
 import type { UnsentWork } from './durability.js';
 import type { JobMarker } from './job.js';
 import { type ConversationWrite, type HeldConversation, type HeldRow, type MessageWindow } from './messages.js';
-import type { Plan } from './query.js';
+import type { GroupTotal, Plan } from './query.js';
 import { type ReadAt } from './reads.js';
 import { type ConversationTally, type RoomTally } from './tallies.js';
 import { type Committed, type Covering, type HeldEntry, type HeldLocators, type HeldRoomRow, type HeldRoomWork, type ReplicaOpened, type Referrer, type Resumed, type RoomCommit, type StoredEntry, type TypedEntry, type View } from './stored.js';
@@ -116,6 +116,13 @@ export type OpenedFile = {
     readonly byteLength: number;
     readonly mediaType: string;
 };
+export type OpenedRoom = GroupTotal & {
+    readonly room: string;
+};
+export type OpenedHeld = {
+    readonly rooms: readonly OpenedRoom[];
+    readonly cleanable: number;
+};
 type Asked<A, R> = {
     readonly asked: A;
     readonly answer: R;
@@ -345,6 +352,7 @@ export interface RuntimeRequests {
         readonly key: string;
     }, null>;
     readonly 'opened.clean': Asked<Nothing, number>;
+    readonly 'opened.held': Asked<Nothing, OpenedHeld>;
     readonly 'file.part': Asked<{
         readonly key: string;
         readonly part: number;

package/dist/mdruntime/transfer.d.ts

@@ -0,0 +1,4 @@
+export type Unconfirmed = {
+    kind: 'unconfirmed';
+};
+export declare const unconfirmed: Unconfirmed;

package/dist/mdruntime/turn.d.ts

@@ -0,0 +1,8 @@
+export declare function yielded(): Promise<void>;
+export declare const ROW_WEIGHT = 256;
+export type Later<T> = T | Promise<T>;
+export declare function after<T, R>(value: Later<T>, next: (value: T) => Later<R>): Later<R>;
+export declare function paced(): (weight: number) => Later<void>;
+export declare function inUnits<T>(items: Iterable<T>, each: (item: T) => number, ended?: () => void, paused?: () => Promise<void>): Later<void>;
+export declare function finished<R>(steps: Generator<number, R, void>): R;
+export declare function stepped<R>(steps: Generator<number, R, void>): Later<R>;

package/dist/mdruntime/wire.d.ts

@@ -1,4 +1,4 @@
-import type { ConnectionRefusal } from './connection.js';
+import type { ConnectionRefusal } from './socket.js';
 import type { Described } from './failure.js';
 export type RuntimePort = {
     postMessage(message: unknown): void;
@@ -197,6 +197,7 @@ declare const TOPICS: {
     readonly conversations: 'within';
     readonly agents: 'within';
     readonly figures: 'whole';
+    readonly holdings: 'whole';
     readonly read: 'whole';
 };
 export declare const WIRE: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentshouse/mdruntime-families",
-  "version": "0.1.0-c8a9a2ed09538",
+  "version": "0.1.0-c8d38a26efb97",
   "description": "react-admin and Refine data providers over the MD Runtime client",
   "license": "MIT",
   "type": "module",