@agentshouse/app-bridge 0.1.0-c646d0da70608 → 0.1.0-c66ec79ae3f1a

package/dist/mdruntime/change.d.ts

@@ -1,3 +1,4 @@
+import type { BinaryFile, HeadChange } from './adapter.js';
 export type Change = {
     readonly kind: 'field';
     readonly path: string;
@@ -29,7 +30,6 @@ export type Change = {
     readonly kind: 'binary';
     readonly path: string;
     readonly localId: string;
-    readonly blob: Blob;
     readonly byteLength: number;
     readonly mediaType: string;
     readonly sha256: string;
@@ -40,6 +40,32 @@ export type Change = {
 } | {
     readonly kind: 'remove';
     readonly path: string;
+} | (Arriving & {
+    readonly content: string;
+}) | (Arriving & {
+    readonly binary: BinaryFile;
+});
+type Arriving = {
+    readonly kind: 'arrival';
+    readonly path: string;
+    readonly revision?: string;
+    readonly fileId?: string;
+    readonly change?: HeadChange;
+};
+export type RoomMove = {
+    readonly source: {
+        readonly room: string;
+        readonly baseRoomVersion: string;
+    };
+    readonly destination: {
+        readonly room: string;
+        readonly baseRoomVersion: string;
+        readonly handle: string;
+    };
+    readonly moves: readonly {
+        readonly path: string;
+        readonly to: string;
+    }[];
 };
 export type Precondition = {
     readonly kind: 'field';
@@ -81,8 +107,12 @@ export type ChangeBatch = {
     readonly changes: readonly Change[];
     readonly preconditions: readonly Precondition[];
     readonly writtenBy?: WrittenBy;
+    readonly between?: RoomMove;
 };
 export declare function immutable(batch: ChangeBatch): ChangeBatch;
+export declare function partnerOf(batch: ChangeBatch, locator: string): string | null;
+export declare function leaving(batch: ChangeBatch, locator: string): boolean;
 export declare function landing(changes: readonly Change[], index: number, path: string): string | null;
 export declare function departure(changes: readonly Change[], index: number): string;
 export declare function queuedFile(batch: ChangeBatch, path: string, localId: string): number;
+export {};

package/dist/mdruntime/client.d.ts

@@ -1,9 +1,10 @@
-import type { AppRoom, ConnectionRefusal, HistoryQuery, RoomSchemas, SavedRoomDraft, SaveResult } from './connection.js';
+import type { AppRoom, ConnectionRefusal, HistoryQuery, RoomSchemas, SavedParts, SavedRoomDraft, SaveResult } from './connection.js';
 import type { Member, ServiceMode } from './adapter.js';
 import type { ChatDraft, ConversationAgent, ConversationEntry, ConversationOptions, ConversationView } from './conversation.js';
 import { type Observation } from './observation.js';
 import type { BinaryReference } from './binary.js';
-import type { BinaryAnswer, CallResult, HistoryAnswer, Offline, QueueEntry } from './outcome.js';
+import type { ChosenFile } from './file.js';
+import type { BinaryAnswer, BinaryLinkAnswer, CallResult, HistoryAnswer, Offline, QueueEntry, Resolution } from './outcome.js';
 import type { DocumentQuery, DocumentResult, GroupQuery, GroupResult, PendingResult } from './query.js';
 import type { RoomDraft, RoomDraftParts, RoomDraftWrite } from './room-draft.js';
 import type { SearchRequest, SearchResult } from './search.js';
@@ -25,15 +26,18 @@ export type MdRuntimeClient = {
         discard(room: string, path: string, revision: string): Promise<RoomDraftWrite>;
     };
     save(room: string, roomDrafts: readonly SavedRoomDraft[]): Promise<SaveResult>;
+    saveParts(room: string, parts: readonly SavedParts[]): Promise<SaveResult>;
     presentation: {
         read(): Promise<unknown>;
         write(value: unknown): Promise<void>;
+        edit(members: Readonly<Record<string, unknown>>): Promise<void>;
     };
     conversation: {
         list(): Promise<readonly ConversationEntry[]>;
         read(conversation: string, options?: ConversationOptions): Promise<ConversationView>;
         create(input: unknown): Promise<CallResult>;
         send(conversation: string, operation?: string, draft?: ChatDraft): Promise<CallResult | Offline>;
+        attach(room: string, file: ChosenFile): Promise<CallResult | Offline>;
         answer(conversation: string, answer: unknown): Promise<CallResult>;
         interrupt(conversation: string): Promise<CallResult>;
         kill(conversation: string): Promise<CallResult>;
@@ -42,11 +46,14 @@ export type MdRuntimeClient = {
     };
     chatDraft: {
         write(conversation: string, draft: ChatDraft, revision?: string): Promise<void>;
+        prepend(conversation: string, draft: ChatDraft): Promise<void>;
         discard(conversation: string): Promise<void>;
     };
     history(locator: string, path: string, query?: HistoryQuery): Promise<HistoryAnswer>;
+    resolve(room: string, path: string, destination: string): Promise<Resolution>;
     binaryFile: {
         read(room: string, path: string, revision?: string): Promise<BinaryAnswer>;
+        link(room: string, path: string, revision?: string): Promise<BinaryLinkAnswer>;
         readReference(reference: BinaryReference): Promise<BinaryAnswer>;
     };
     call(name: string, input: unknown): Promise<CallResult>;
@@ -54,6 +61,7 @@ export type MdRuntimeClient = {
     log(): Promise<string>;
     persistence(): Promise<boolean>;
     retry(): Promise<void>;
+    cleanUp(): Promise<number>;
     observe: {
         (topic: 'deployment-facts'): Promise<Observation<unknown>>;
         (topic: 'rooms'): Promise<Observation<readonly AppRoom[]>>;
@@ -77,6 +85,7 @@ export type MdRuntimeClient = {
 };
 export declare function connectMdRuntime(port: RuntimePort): MdRuntimeClient;
 export declare function inTurn(client: MdRuntimeClient, work: () => Promise<void>): Promise<void>;
+export { chainedWindows, type WindowAnswer, type WindowChain } from './chain.js';
 export type { Observation } from './observation.js';
 export type { Open } from './open.js';
 export { unanswered, type RuntimePort, type WireMember } from './wire.js';

package/dist/mdruntime/collection.d.ts

@@ -1,9 +1,8 @@
-import { type Document, type Frontmatter, type Validation } from '../mdmodel/index.js';
-import { type ModelState } from './model.js';
+import { type Document } from '../mdmodel/index.js';
+import type { ModelState } from './model.js';
 import type { MdModelIdentity } from './adapter.js';
 import { type Paths } from './shared.js';
 import type { Refused } from './transfer.js';
-import { type Later } from './turn.js';
 export declare const MD_MODEL: MdModelIdentity;
 export type Collection = {
     text: Readonly<Record<string, string>>;
@@ -17,22 +16,10 @@ export type Composition = {
         model: ModelState;
     } | null;
 };
+export declare function selected(composition: Composition, path: string): boolean;
 export declare function governing(composition: Composition, path: string): ModelState;
-export declare function collectionOf(text: Readonly<Record<string, string>>, composition: Composition, previous?: Collection): Collection;
-export declare function passingFrontmatter(collection: Collection, path: string): Frontmatter | undefined;
-export declare function documentsOf(collection: Collection): Generator<readonly [string, Document]>;
-export declare function unreadable(text: Readonly<Record<string, string>>, previous?: Readonly<Record<string, string>>): Refused | null;
+export declare function collectionOf(text: Readonly<Record<string, string>>, composition: Composition): Collection;
+export declare function documentsOf(collection: Collection): Generator<number, Iterable<readonly [string, Document]>, void>;
+export declare function unreadable(text: Paths<string>, paths?: Iterable<string> | null): Generator<number, Refused | null, void>;
 export declare function validRoot(root: unknown): root is string;
-export declare function validateCollection(text: Readonly<Record<string, string>>, binaryTargets: readonly string[], composition: Composition): Validation;
-type Held = {
-    text: Paths<string>;
-    binaries: Paths<unknown>;
-};
-export declare function indexReferrers(held: Held, composition: Composition): Later<void>;
-export declare function referencesIndexed(held: Held, composition: Composition): boolean;
-export declare function referring(held: Held, composition: Composition, targets: Iterable<string>): ReadonlySet<string> | null;
 export declare function available(composition: Composition): boolean;
-export declare function changedCleanly(next: Held, previous: Held & {
-    composition: Composition;
-}, composition: Composition): boolean;
-export {};

package/dist/mdruntime/compile.d.ts

@@ -0,0 +1,10 @@
+import type { Plan, QueryRows } from './query.js';
+import type { Connection } from './tables.js';
+export type QueryRoom = {
+    readonly locator: string;
+    readonly key: number;
+};
+export type QueryAnswer = QueryRows & {
+    readonly more?: string;
+};
+export declare function answerQuery(connection: Connection, plan: Plan, rooms: readonly QueryRoom[], budget?: number | null): QueryAnswer;

package/dist/mdruntime/connection.d.ts

@@ -1,20 +1,21 @@
 import { type TypesResult } from './model.js';
 import { type Observation } from './observation.js';
 import { type DocumentQuery, type DocumentResult, type GroupQuery, type GroupResult, type PendingResult } from './query.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 BinaryReference } from './binary.js';
-import { type BinaryAnswer, type CallResult, type HistoryAnswer, type QueueEntry } from './outcome.js';
+import { type BinaryLinkAnswer, type CallResult, type HeldBinaryAnswer, type HistoryAnswer, type QueueEntry, type Resolution } from './outcome.js';
 import { type Recovery } from './recovery.js';
 import { type SaveRefusal } from './save.js';
-import { type RoomDraft, type RoomDraftWrite } from './room-draft.js';
+import { type RoomDraft, type RoomDraftParts, type RoomDraftWrite } from './room-draft.js';
 import { type SyncStatus } from './status.js';
 import { type RuntimeShell } from './durability.js';
-import { type RuntimeDemand } from './acquisition.js';
-import { type CapacityCause, type CodeAvailability, type Persistence, type Readiness } from './readiness.js';
+import { type CapacityCause, type CodeAvailability, type Persistence, type Readiness, type SearchObligation } from './readiness.js';
+import type { RuntimeDatabase } from './tables.js';
 import { type NarrowedView, type PortReach, type RuntimeView } from './reach.js';
 export type AppTypedSelection = {
     roots: readonly string[];
@@ -33,6 +34,7 @@ export type AppRoom = {
     documents: number;
     synchronizationAvailable: boolean;
     refusal: ProviderRefusal | null;
+    locked: boolean;
 };
 export type RoomSchemas = {
     collection: TypesResult;
@@ -49,6 +51,7 @@ export type ConnectionRefusal = {
 export type MdRuntimeOptions = {
     adapter: Adapter;
     shell: RuntimeShell;
+    database: RuntimeDatabase;
     authorization?: Authorization;
     signal?: AbortSignal;
     recovery?: Recovery;
@@ -63,19 +66,26 @@ export type SavedRoomDraft = {
     readonly path: string;
     readonly revision: string;
 };
+export type SavedParts = {
+    readonly path: string;
+    readonly parts: RoomDraftParts;
+};
 export type RoomDraftSurface = {
     list(): Promise<readonly RoomDraft[]>;
-    read(room: string, path: string): RoomDraft | null;
+    read(room: string, path: string): Promise<RoomDraft | null>;
     write(room: string, path: string, revision: string | null, parts: unknown): Promise<RoomDraftWrite>;
     discard(room: string, path: string, revision: string): Promise<RoomDraftWrite>;
 };
 export type PresentationSurface = {
     read(app: string): Promise<unknown>;
     write(app: string, value: unknown): Promise<void>;
+    edit(app: string, members: Readonly<Record<string, unknown>>): Promise<void>;
 };
 export type BinaryFileSurface = {
-    read(room: string, path: string, revision?: string): Promise<BinaryAnswer>;
-    readReference(reference: BinaryReference): Promise<BinaryAnswer>;
+    read(room: string, path: string, revision?: string): Promise<HeldBinaryAnswer>;
+    link(room: string, path: string, revision?: string): Promise<BinaryLinkAnswer>;
+    readReference(reference: BinaryReference): Promise<HeldBinaryAnswer>;
+    part(file: string, part: number): Promise<Uint8Array | null>;
 };
 export type HistoryQuery = {
     revision?: string;
@@ -95,13 +105,16 @@ export type MdRuntime = {
     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): boolean;
+    reached(locator: string, roomVersion: string, path?: string): Promise<boolean>;
     log(): string;
     persistence(): boolean;
     retry(): Promise<void>;
+    cleanUp(): Promise<number>;
     observe: {
         (topic: 'rooms'): Promise<Observation<readonly AppRoom[]>>;
         (topic: 'readiness'): Promise<Observation<Readiness>>;
@@ -126,11 +139,12 @@ export type ReadinessPort = {
     readonly target: string;
     readonly code: CodeAvailability;
     readonly capacity: CapacityCause | null;
+    readonly search: SearchObligation;
 };
 export type ComposedRuntime = RuntimeView & {
+    seed(entry: EntrySeed): void;
     stop(): Promise<void>;
     lose(locators: readonly string[]): Promise<void>;
-    acquire(demand: RuntimeDemand): void;
     persisted(answer: Persistence): void;
     within(reach: PortReach | null, port: ReadinessPort): NarrowedView;
 };

package/dist/mdruntime/conversation.d.ts

@@ -1,6 +1,6 @@
 import type { ConversationAction, ConversationAgents, ConversationEvent, ConversationMessage, ConversationStream, ProcessCommand, SessionOption, TurnContext } from './adapter.js';
 import { type ChangeSet } from './change-set.js';
-import { type ChatDraftFile } from './file.js';
+import { type ChosenFile } from './file.js';
 import type { Open } from './open.js';
 import { type CallResult, type Offline } from './outcome.js';
 import type { DocumentResult, PendingResult } from './query.js';
@@ -17,6 +17,7 @@ export type ConversationEntry = {
     created: string;
     finished: string | null;
     outcome: string | null;
+    waiting: boolean;
     state: ConversationState;
     started: string | null;
 };
@@ -32,14 +33,17 @@ export type RunningTurn = {
 };
 export type ChatDraft = {
     text: string;
-    files: readonly ChatDraftFile[];
 };
 export type ConversationOptions = {
     limit?: number;
+    after?: string;
+    total?: true;
 };
 export type ConversationView = {
     conversation: string;
     messages: readonly ConversationMessage[];
+    next?: string;
+    total?: number;
     turn: RunningTurn | null;
     questions: readonly unknown[];
     process: {
@@ -47,6 +51,11 @@ export type ConversationView = {
     } | null;
     commands: readonly ProcessCommand[];
     options: readonly SessionOption[];
+    starting: string | null;
+    link: {
+        connected: boolean;
+    } | null;
+    deliveryUnknown: readonly string[];
     chatDraft: (ChatDraft & {
         readonly revision: string;
     }) | null;
@@ -56,6 +65,7 @@ export type ConversationSurface = {
     read(conversation: string, options?: ConversationOptions): Promise<ConversationView>;
     create(input: unknown): Promise<CallResult>;
     send(conversation: string, operation?: string, draft?: ChatDraft): Promise<CallResult | Offline>;
+    attach(room: string, file: ChosenFile): Promise<CallResult | Offline>;
     answer(conversation: string, answer: unknown): Promise<CallResult>;
     interrupt(conversation: string): Promise<CallResult>;
     kill(conversation: string): Promise<CallResult>;
@@ -64,11 +74,12 @@ export type ConversationSurface = {
 };
 export type ChatDraftSurface = {
     write(conversation: string, draft: ChatDraft, revision?: string): Promise<void>;
+    prepend(conversation: string, draft: ChatDraft): Promise<void>;
     discard(conversation: string): Promise<void>;
 };
 export type ConversationDependencies = {
     agents(): ConversationAgents | undefined;
-    documents(agents: ConversationAgents): Promise<DocumentResult | PendingResult>;
+    documents(agents: ConversationAgents, after: string | undefined): Promise<DocumentResult | PendingResult>;
     call(name: ConversationAction, input: unknown): Promise<CallResult>;
     durably<T>(work: (local: RuntimeStore) => Promise<T>): Promise<T>;
     stream(): ConversationStream | undefined;
@@ -89,6 +100,7 @@ export type ConversationStore = {
     known(): boolean;
     reconnected(): void;
     reopened(): void;
+    lost(): void;
     watch(conversation: string, options: ConversationOptions, deliver: (view: ConversationView) => void): () => void;
     watchList(deliver: (entries: readonly ConversationEntry[]) => void): () => void;
     watchAgents(deliver: (agents: readonly ConversationAgent[]) => void): () => void;

package/dist/mdruntime/durability.d.ts

@@ -1,7 +1,7 @@
 import type { Persistence } from './readiness.js';
 export type StorageEstimate = {
     readonly usage: number;
-    readonly quota: number;
+    readonly total: number;
 };
 export type RuntimeShell = {
     persistence: Persistence;
@@ -9,6 +9,7 @@ export type RuntimeShell = {
     keepGeneration(value: string): void | Promise<void>;
     dropGeneration(): void | Promise<void>;
     estimate?(): Promise<StorageEstimate | null>;
+    cleanUp?(): Promise<number>;
 };
 export declare function detectStorageLoss(stored: string | null, reported: string | null): string | null;
 export declare function nextGeneration(stored: string | null, reported: string | null): string;

package/dist/mdruntime/file.d.ts

@@ -1,4 +1,4 @@
-export type ChatDraftFile = {
+export type ChosenFile = {
     name: string;
     blob: Blob;
 };
@@ -7,13 +7,5 @@ export type FileDeclaration = {
     mediaType: string;
     byteLength: number;
     contentHash: string;
-    width?: number;
-    height?: number;
 };
-export type Extent = {
-    width: number;
-    height: number;
-};
-export declare function extentOf(bytes: Uint8Array): Extent | null;
-export declare function hexDigest(digest: ArrayBuffer): string;
-export declare function declaredFile(file: ChatDraftFile): Promise<FileDeclaration>;
+export declare function declaredFile(file: ChosenFile): Promise<FileDeclaration>;

package/dist/mdruntime/observation.d.ts

@@ -14,6 +14,8 @@ export type QueryChange = {
     removed: readonly RowKey[];
     order: readonly RowKey[] | null;
     coverage?: QueryCoverage;
+    next?: string | null;
+    total?: number;
 };
 export type QueryMessage = KeyedResult | QueryChange;
 export type Observed = {
@@ -27,3 +29,15 @@ export declare function applied(keyed: KeyedResult, message: QueryMessage): Keye
 export declare function observed(first: unknown, stop: () => void, keyed: boolean): Observed;
 export declare function opened(watch: (deliver: (message: unknown) => void) => () => void, keyed: boolean): Promise<Observation<unknown>>;
 export declare function observing<Topic extends string>(watch: (topic: Topic, input: readonly unknown[], deliver: (message: unknown) => void) => () => void): (topic: Topic, ...input: unknown[]) => Promise<Observation<unknown>>;
+export type Digest = {
+    readonly pending: string;
+} | {
+    readonly keys: readonly RowKey[];
+    readonly rows: ReadonlyMap<RowKey, number>;
+    readonly coverage: string;
+    readonly next: string | undefined;
+    readonly total: number | undefined;
+};
+export declare function digestOf({ result, keys }: KeyedResult): Digest;
+export declare function digestApplied(digest: Digest, message: QueryMessage): Digest;
+export declare function changeOf(previous: Digest, next: KeyedResult): QueryMessage | null;

package/dist/mdruntime/opened.d.ts

@@ -0,0 +1,21 @@
+import type { BinaryResult } from './adapter.js';
+import { type RuntimeDatabase } from './tables.js';
+export type OpenedName = {
+    readonly locator: string;
+    readonly path: string;
+    readonly revision: string;
+};
+export type KeptBinary = {
+    readonly kind: 'binary';
+    readonly file: string;
+    readonly byteLength: number;
+    readonly mediaType: string;
+};
+export type KeptResult = KeptBinary | Exclude<BinaryResult, {
+    kind: 'binary';
+}>;
+export type OpenedFiles = {
+    find(name: OpenedName): Promise<KeptBinary | null>;
+    fetch(name: OpenedName, read: () => Promise<BinaryResult>): Promise<KeptResult>;
+};
+export declare function openedFiles(database: RuntimeDatabase, fenced: (locator: string) => boolean): OpenedFiles;

package/dist/mdruntime/outcome.d.ts

@@ -1,10 +1,13 @@
-import type { ActionResult, AdapterFailure, BinaryResult, HistoryResult, ProviderRefusal, RoomVersionAt, ScopedRefusal } from './adapter.js';
+import type { ActionResult, AdapterFailure, BinaryLinkResult, HistoryResult, HistoryRevision, ProviderRefusal, RoomVersionAt, ScopedRefusal } from './adapter.js';
 import type { ChangeBatch } from './change.js';
+import type { KeptBinary, KeptResult } from './opened.js';
 type Refused<Kind extends string> = ProviderRefusal & {
     kind: Kind;
 };
 export type Failure = Refused<'transport-uncertainty'> | Refused<'revoked-authorization'> | (Refused<'room-not-readable'> & {
     locator: string;
+}) | (Refused<'room-locked'> & {
+    locator: string;
 }) | ScopedRefusal;
 export type CallResult = {
     kind: 'action';
@@ -14,12 +17,40 @@ export type CallResult = {
 export type HistoryAnswer = Exclude<HistoryResult, {
     kind: Failure['kind'];
 }> | Failure;
+type BinaryRefusal = Refused<'rejected'> | Refused<'absent'> | Failure;
 export type BinaryAnswer = {
     kind: 'binary';
-    blob: Blob;
+    stream: ReadableStream<Uint8Array>;
+    byteLength: number;
+    mediaType: string;
+} | BinaryRefusal;
+export type HeldBinaryAnswer = KeptBinary | BinaryRefusal;
+export type BinaryLinkAnswer = {
+    kind: 'link';
+    url: string;
+    name: string;
 } | Refused<'rejected'> | Refused<'absent'> | Failure;
-export declare function absentBinary(path: string): BinaryAnswer;
-export declare function binaryAnswer(result: BinaryResult): BinaryAnswer;
+export type Resolution = {
+    readonly kind: 'document';
+    readonly room: string;
+    readonly path: string;
+} | {
+    readonly kind: 'deleted';
+    readonly room: string;
+    readonly path: string;
+    readonly revision: HistoryRevision;
+} | Refused<'unreadable'> | Refused<'absent'> | Failure;
+export declare const UNREADABLE: Refused<'unreadable'>;
+export declare const LOCKED_UNREADABLE: Refused<'unreadable'>;
+export declare const ABSENT_TARGET: Refused<'absent'>;
+export declare function absentBinary(path: string): Refused<'absent'>;
+export declare function absentReference(fileRef: string): Refused<'absent'>;
+export declare function binaryAnswer(result: KeptResult): HeldBinaryAnswer;
+export declare function binaryLinkAnswer(result: BinaryLinkResult): BinaryLinkAnswer;
+export declare const ROOM_LOCKED = "room-locked";
+export declare function lockedRoom(locator: string): Refused<'room-locked'> & {
+    locator: string;
+};
 export type Offline = {
     readonly kind: 'offline';
 };

package/dist/mdruntime/overlay.d.ts

@@ -2,6 +2,7 @@ import type { BinaryFile, HeadChange } from './adapter.js';
 import type { ChangeBatch } from './change.js';
 export type Heads = {
     revisions: Readonly<Record<string, string>>;
+    fileIds: Readonly<Record<string, string>>;
     changes: Readonly<Record<string, HeadChange>>;
 };
 export type HeldBinary = ({
@@ -17,10 +18,7 @@ export type Layer = Heads & {
     documents: Readonly<Record<string, string>>;
     binaries: Readonly<Record<string, HeldBinary>>;
 };
-export declare function acceptedBinaries(files: Readonly<Record<string, BinaryFile>>): Record<string, HeldBinary>;
+export declare function acceptedBinaries(files: Readonly<Record<string, BinaryFile>>): Generator<readonly [string, HeldBinary]>;
 export declare function sameBinary(left: HeldBinary | undefined, right: HeldBinary | undefined): boolean;
 export declare function sameChange(left: HeadChange | undefined, right: HeadChange | undefined): boolean;
-export declare function overlay(base: Layer, queue: readonly ChangeBatch[], unapplied?: () => void): Layer;
-export declare function sameLayerText(left: Layer, right: Layer): boolean;
-export declare function changedPaths(left: Layer, right: Layer): ReadonlySet<string>;
-export declare function overlayChanged(base: Layer, queue: readonly ChangeBatch[], previousBase: Layer, previousQueue: readonly ChangeBatch[], previousVisible: Layer): Layer;
+export declare function overlaying(base: Layer, queue: readonly ChangeBatch[], unapplied?: () => void): Generator<number, Layer, void>;

package/dist/mdruntime/query.d.ts

@@ -38,6 +38,8 @@ export type Filter = {
     types?: readonly string[];
     where?: Where;
     pathPrefix?: string;
+    folder?: string;
+    paths?: readonly string[];
     hop?: Related & {
         field: string;
     };
@@ -45,7 +47,7 @@ export type Filter = {
         field?: string;
     };
 };
-export type Key = 'room' | 'path' | 'type' | {
+export type Key = 'room' | 'path' | 'type' | 'folder' | {
     field: string;
 };
 export type Select = 'all' | {
@@ -55,6 +57,7 @@ export type Select = 'all' | {
     markdown?: true;
     backlinks?: true;
     change?: true;
+    fileId?: true;
 };
 export type OrderOptions = {
     nulls?: 'first' | 'last';
@@ -70,6 +73,8 @@ export type DocumentQuery = Filter & {
         direction?: Direction;
     } & OrderOptions)[];
     limit?: number;
+    after?: string;
+    total?: true;
 };
 export type GroupQuery = Filter & {
     groupBy: readonly Exclude<Key, 'path'>[];
@@ -78,6 +83,8 @@ export type GroupQuery = Filter & {
         direction?: Direction;
     }[];
     limit?: number;
+    after?: string;
+    total?: true;
 };
 export type LocalQuery = DocumentQuery | GroupQuery;
 export type Backlink = {
@@ -95,6 +102,7 @@ export type QueryDocument = {
     markdown?: string;
     backlinks?: readonly Backlink[];
     change?: HeadChange | null;
+    fileId?: string | null;
     binaryFile?: BinaryFileRecord;
 };
 export type QueryGroup = {
@@ -111,7 +119,7 @@ export type QueryCoverage = {
     indexes: readonly string[];
     overlay: readonly string[];
 };
-export type Awaits = Open<'acquisition' | 'preparation' | 'index'>;
+export type Awaits = Open<'acquisition' | 'preparation' | 'index' | 'unlock'>;
 export type PendingRoom = {
     room: string;
     awaits: Awaits;
@@ -121,9 +129,13 @@ export type PendingResult = {
 };
 export type DocumentRows = {
     documents: readonly QueryDocument[];
+    next?: string;
+    total?: number;
 };
 export type GroupRows = {
     groups: readonly QueryGroup[];
+    next?: string;
+    total?: number;
 };
 export type QueryRows = DocumentRows | GroupRows;
 export type DocumentResult = DocumentRows & {
@@ -187,6 +199,8 @@ export type KeyPlan = {
     of: 'path';
 } | {
     of: 'type';
+} | {
+    of: 'folder';
 } | {
     of: 'field';
     field: string;
@@ -199,6 +213,7 @@ export type DocumentShape = {
     markdown: boolean;
     backlinks: boolean;
     change: boolean;
+    fileId: boolean;
     orderBy: readonly {
         key: KeyPlan;
         options: OrderOptions & {
@@ -218,10 +233,18 @@ export type PlanReach = {
     rooms: readonly string[];
     documents: readonly string[];
 };
+export type Continuation = {
+    text: string;
+    values: readonly unknown[] | null;
+};
 export type Plan = {
+    key: string;
     rooms: readonly string[] | null;
     reach: PlanReach | null;
+    locked: readonly string[];
     root: Scope;
+    folder: string | null;
+    paths: readonly string[] | null;
     hop: (Scope & {
         field: string;
     }) | null;
@@ -230,6 +253,8 @@ export type Plan = {
     }) | null;
     shape: DocumentShape | GroupShape;
     limit: number | null;
+    after: Continuation | null;
+    total: boolean;
 };
 export declare class QueryError extends Error {
     readonly code: QueryErrorCode;
@@ -240,8 +265,10 @@ type Entries = Readonly<Record<string, unknown>>;
 export declare function invalid(at: string, problem: string): never;
 export declare function plain(value: unknown): value is Entries;
 export declare function known(value: Entries, allowed: readonly string[], at: string): void;
+export declare function flag(input: unknown, at: string): boolean;
 export declare function planOf(input: unknown, facts: HeldRooms, reach?: PlanReach | null): Plan;
 export declare function limitOf(input: unknown): number | null;
 export declare function filterOf(input: unknown, facts: HeldRooms, reach?: PlanReach | null): Plan;
+export declare function queryKey(query: unknown): string;
 export declare function identityOf(plan: Plan): string;
 export {};