@agentshouse/app-bridge 0.1.0-cc916a0fcfdc4 → 0.1.0-ccabf1b730c99

package/dist/calls.d.ts

@@ -64,6 +64,19 @@ export interface HouseMethods {
             readonly url: string;
         };
     };
+    readonly 'conversation.attach': {
+        readonly params: {
+            readonly blob: Blob;
+            readonly byteLength: number;
+            readonly contentHash: string;
+            readonly mediaType: string;
+            readonly name: string;
+            readonly room: string;
+        };
+        readonly result: {
+            readonly path: string;
+        };
+    };
     readonly 'conversation.create': {
         readonly params: {
             readonly agent_id: string;
@@ -192,40 +205,13 @@ export interface HouseMethods {
     readonly 'conversation.send': {
         readonly params: {
             readonly conversation: string;
-            readonly files?: readonly {
-                readonly blob: Blob;
-                readonly byteLength: number;
-                readonly contentHash: string;
-                readonly height?: number;
-                readonly mediaType: string;
-                readonly name: string;
-                readonly width?: number;
-            }[];
             readonly operation_id: string;
-            readonly text?: string;
+            readonly text: string;
         };
         readonly result: {
             readonly agent_id: string;
             readonly authority: string;
             readonly conversation_id: string;
-            readonly files: readonly {
-                readonly name: string;
-                readonly media_type: string | null;
-                readonly dimensions: {
-                    readonly width: number;
-                    readonly height: number;
-                } | null;
-                readonly bytes: number;
-                readonly sha256: string;
-                readonly file: string | null;
-                readonly page: string;
-                readonly upload?: {
-                    readonly method: 'POST';
-                    readonly operation: string;
-                    readonly url: string;
-                    readonly expires_at: string;
-                };
-            }[];
             readonly log_epoch: string;
             readonly message_id: string;
             readonly position: string;
@@ -278,6 +264,86 @@ export interface HouseMethods {
             readonly log_epoch: string;
         };
     };
+    readonly 'inboxChat.assign': {
+        readonly params: {
+            readonly room_ref: string;
+            readonly path: string;
+            readonly assignee: {
+                readonly user: string;
+            } | {
+                readonly agent: string;
+            } | null;
+        };
+        readonly result: {
+            readonly room_ref: string;
+            readonly path: string;
+            readonly assignee: {
+                readonly user: string;
+                readonly name: string;
+            } | {
+                readonly agent: string;
+                readonly name: string;
+            } | null;
+            readonly return_to: {
+                readonly agent: string;
+                readonly name: string;
+            } | null;
+            readonly authority: string;
+            readonly position: string;
+            readonly log_epoch: string;
+            readonly url: string;
+        };
+    };
+    readonly 'inboxChat.return': {
+        readonly params: {
+            readonly room_ref: string;
+            readonly path: string;
+        };
+        readonly result: {
+            readonly room_ref: string;
+            readonly path: string;
+            readonly assignee: {
+                readonly user: string;
+                readonly name: string;
+            } | {
+                readonly agent: string;
+                readonly name: string;
+            } | null;
+            readonly return_to: {
+                readonly agent: string;
+                readonly name: string;
+            } | null;
+            readonly authority: string;
+            readonly position: string;
+            readonly log_epoch: string;
+            readonly url: string;
+        };
+    };
+    readonly 'inboxChat.takeControl': {
+        readonly params: {
+            readonly room_ref: string;
+            readonly path: string;
+        };
+        readonly result: {
+            readonly room_ref: string;
+            readonly path: string;
+            readonly assignee: {
+                readonly user: string;
+                readonly name: string;
+            } | {
+                readonly agent: string;
+                readonly name: string;
+            } | null;
+            readonly return_to: {
+                readonly agent: string;
+                readonly name: string;
+            } | null;
+            readonly authority: string;
+            readonly position: string;
+            readonly log_epoch: string;
+            readonly url: string;
+        };
+    };
     readonly 'member.list': {
         readonly params: {
             readonly room_ref: string;
@@ -865,11 +931,6 @@ export interface HouseMethods {
                         readonly enabled: boolean;
                         readonly access?: string;
                         readonly payload: string;
-                        readonly references: readonly {
-                            readonly room_ref: string;
-                            readonly ref: string;
-                            readonly url: string;
-                        }[];
                         readonly holds: boolean;
                     })[];
                 }[];
@@ -899,6 +960,10 @@ export interface HouseMethods {
                     readonly position: number;
                     readonly outcome: 'requested';
                     readonly request: string;
+                } | {
+                    readonly position: number;
+                    readonly outcome: 'continued';
+                    readonly request: string;
                 } | {
                     readonly position: number;
                     readonly outcome: 'refused';
@@ -907,12 +972,12 @@ export interface HouseMethods {
                     readonly position: number;
                     readonly outcome: 'refused';
                     readonly code: 'limit_reached';
-                    readonly limit: 'sites' | 'custom_domains' | 'publish_data' | 'site_submissions' | 'external_calls' | 'routine_requests' | 'routine_mail';
+                    readonly limit: 'sites' | 'custom_domains' | 'publish_data' | 'site_submissions' | 'mcp_reads' | 'mcp_downloads' | 'external_calls' | 'routine_requests' | 'routine_mail';
                 } | {
                     readonly position: number;
                     readonly outcome: 'refused';
                     readonly code: 'limit_reached';
-                    readonly limit: 'sites' | 'custom_domains' | 'publish_data' | 'site_submissions' | 'external_calls' | 'routine_requests' | 'routine_mail';
+                    readonly limit: 'sites' | 'custom_domains' | 'publish_data' | 'site_submissions' | 'mcp_reads' | 'mcp_downloads' | 'external_calls' | 'routine_requests' | 'routine_mail';
                     readonly retry_at: string;
                 } | {
                     readonly position: number;
@@ -936,23 +1001,16 @@ export interface HouseMethods {
                     readonly limit: 'writes';
                     readonly period: 'minute' | 'day';
                     readonly retry_at: string;
-                } | {
-                    readonly position: number;
-                    readonly outcome: 'refused';
-                    readonly code: 'limit_reached';
-                    readonly limit: 'mcp_reads' | 'mcp_downloads';
-                    readonly value: string;
-                    readonly retry_at: string;
                 } | {
                     readonly position: number;
                     readonly outcome: 'refused';
                     readonly code: 'cap_reached';
-                    readonly cap: 'address_submissions' | 'writes' | 'push_addresses' | 'push_deliveries' | 'external_accounts' | 'export_starts' | 'share_creations' | 'share_room_creations' | 'live_shares' | 'ownership_offers' | 'site_rooms' | 'slot_rooms' | 'room_triggers' | 'app_sockets' | 'kit_connections';
+                    readonly cap: 'address_submissions' | 'writes' | 'push_addresses' | 'push_deliveries' | 'external_accounts' | 'shared_schemas' | 'export_starts' | 'share_creations' | 'share_room_creations' | 'live_shares' | 'ownership_offers' | 'site_rooms' | 'slot_rooms' | 'room_triggers' | 'app_sockets' | 'kit_connections' | 'open_uploads' | 'waiting_web_wizards';
                 } | {
                     readonly position: number;
                     readonly outcome: 'refused';
                     readonly code: 'cap_reached';
-                    readonly cap: 'address_submissions' | 'writes' | 'push_addresses' | 'push_deliveries' | 'external_accounts' | 'export_starts' | 'share_creations' | 'share_room_creations' | 'live_shares' | 'ownership_offers' | 'site_rooms' | 'slot_rooms' | 'room_triggers' | 'app_sockets' | 'kit_connections';
+                    readonly cap: 'address_submissions' | 'writes' | 'push_addresses' | 'push_deliveries' | 'external_accounts' | 'shared_schemas' | 'export_starts' | 'share_creations' | 'share_room_creations' | 'live_shares' | 'ownership_offers' | 'site_rooms' | 'slot_rooms' | 'room_triggers' | 'app_sockets' | 'kit_connections' | 'open_uploads' | 'waiting_web_wizards';
                     readonly retry_at: string;
                 } | {
                     readonly position: number;

package/dist/index.d.ts

@@ -21,6 +21,7 @@ export interface HouseCredentialState {
     readonly state: Open<'none' | 'held' | 'rejected'>;
     readonly expiresAt: number | null;
 }
+export type HouseDatabaseFailure = 'unsupported' | 'damaged' | 'update-required';
 export type HouseAnalyticsChoice = 'accept' | 'decline';
 export interface HouseAnalytics {
     readonly measures: boolean;
@@ -40,6 +41,7 @@ export interface HouseStatus {
         readonly retryable: boolean;
     } | null;
     readonly loss: string | null;
+    readonly database: Open<HouseDatabaseFailure> | null;
     readonly analytics: HouseAnalytics;
     readonly serviceMode: Open<'open' | 'write-halted'> | null;
     readonly offline: boolean;

package/dist/mdmodel/definition.d.ts

@@ -77,4 +77,4 @@ export type PointerFacts = {
 export declare function crossedFacts(facts: ValueFacts): ValueFacts[];
 export declare function fieldFacts(definition: Definition, key: string): ValueFacts | undefined;
 export declare function pointerFacts(definition: Definition, pointer: string): PointerFacts | undefined;
-export declare function readSchema(text: string): VerifiedModel | Failure;
+export declare function readSchema(text: string, provided?: VerifiedModel): VerifiedModel | Failure;

package/dist/mdmodel/document.d.ts

@@ -1,6 +1,6 @@
 import { type Definition } from './definition.js';
 import { type LinkInventory } from './links.js';
-import type { ApplyResult, BodyResult, FrontmatterResult, Change, Document, Link, LinkOccurrence, ParseResult } from './types.js';
+import type { ApplyResult, BodyResult, FrontmatterResult, Change, Document, Link, ParseResult } from './types.js';
 import { type YamlMap } from './yaml.js';
 export declare function inventoryOf(document: Document): LinkInventory;
 export declare function parseFrontmatter(content: string, file?: string): FrontmatterResult;
@@ -9,9 +9,7 @@ export declare function relativize(document: Document, file: string, handle: str
 export declare function relativizeBody(body: string, file: string, handle: string): BodyResult;
 export declare function relinkBody(body: string, file: string, moves: ReadonlyMap<string, string>): BodyResult;
 export declare function links(document: Document, file: string): readonly Link[];
-export declare function linkOccurrences(document: Document, file: string): readonly LinkOccurrence[];
 export declare function bodyLinks(body: string, file: string): readonly Link[];
 export declare function apply(document: Document, changes: readonly Change[]): ApplyResult;
 export declare function serialize(document: Document): string;
-export declare function fieldStart(document: Document, pointer: string): number | undefined;
 export declare function frontmatter(document: Document): YamlMap | null;

package/dist/mdmodel/index.d.ts

@@ -3,7 +3,7 @@ export type { Actor, Condition, ConditionOperator, ConditionScope, ConditionTest
 export { headingLines } from './blocks.js';
 export type { HeadingLine } from './blocks.js';
 export { divide } from './divide.js';
-export { apply, bodyLinks, fieldStart, linkOccurrences, links, parse, parseFrontmatter, relativize, relativizeBody, relinkBody, serialize, } from './document.js';
+export { apply, bodyLinks, links, parse, parseFrontmatter, relativize, relativizeBody, relinkBody, serialize, } from './document.js';
 export { HOUSE_FIELDS, MEMBER_FIELD, RECEIVED_FIELD, SITE_FIELD, TYPE_FIELD } from './fields.js';
 export { relative, retarget, roomPath, roomTarget, target } from './paths.js';
 export type { RoomTarget } from './paths.js';
@@ -12,8 +12,9 @@ export { project } from './project.js';
 export { references } from './references.js';
 export { ARRAY_INDEX, ATTACHMENT, crossedFacts, escapePointer, itemFacts, memberFacts, pointerFacts, pointerSegments, } from './definition.js';
 export type { Definition, FieldRules, JsonType, PatternFacts, PointerFacts, RuleValue, SectionSpec, Shape, Transition, ValueFacts, } from './definition.js';
-export type { ApplyResult, BodyResult, Change, Division, DivisionContext, Document, DocumentCheck, Frontmatter, FrontmatterResult, Library, ModelVerification, Link, LinkOccurrence, ParseResult, Projection, ProjectionContext, Reached, Reference, Refusal, RoomReference, Span, Validation, ValidationContext, ValidationStep, VerifiedModel, } from './types.js';
-export { bodyRoomLinks, checkDocument, resolves, roomReferences, sectionReferences, validate, validating, verify, } from './validate.js';
+export type { ApplyResult, BodyResult, Change, Division, DivisionContext, Document, DocumentCheck, Frontmatter, FrontmatterResult, Library, ModelVerification, Link, ParseResult, Projection, ProjectionContext, Reached, Reference, Refusal, RoomReference, Span, Validation, ValidationContext, ValidationStep, VerifiedModel, } from './types.js';
+export { assess, bodyRoomLinks, checkDocument, resolves, roomReferences, sectionReferences, validate, validating, verdicts, verify, } from './validate.js';
+export type { Assessment, Verdicts } from './validate.js';
 export { VERSION } from './version.js';
 export { bodyAfterFrontmatter, equalValue, frontmatterValue } from './yaml.js';
 export type { FrontmatterValue } from './yaml.js';

package/dist/mdmodel/types.d.ts

@@ -97,9 +97,6 @@ export type Link = {
     readonly href: string;
     readonly target: string;
 };
-export type LinkOccurrence = Link & {
-    readonly start: number;
-};
 export type Reference = {
     readonly pointer: string;
     readonly value: string;

package/dist/mdmodel/validate.d.ts

@@ -1,10 +1,31 @@
 import { type Definition } from './definition.js';
 import type { DocumentCheck, Library, ModelVerification, Reached, RoomReference, Validation, ValidationContext, ValidationStep, VerifiedModel } from './types.js';
 export declare function resolves(reference: Reached, typeOf: (path: string) => string | undefined, binary: (path: string) => boolean): boolean;
-export declare function verify(schema: string): ModelVerification;
+export declare function verify(schema: string, provided?: VerifiedModel): ModelVerification;
 export declare function checkDocument(file: string, content: string, model: VerifiedModel, context?: Pick<ValidationContext, 'anyRoom'>): DocumentCheck;
 export declare function sectionReferences(file: string, content: string, definition: Definition): readonly Reached[];
 export declare function bodyRoomLinks(body: string): RoomReference[];
 export declare function roomReferences(file: string, content: string, definition?: Definition): readonly RoomReference[];
+type Placed = {
+    readonly reference: Reached;
+    readonly location: string;
+};
+export type Assessment = {
+    readonly file: string;
+    readonly type: string | undefined;
+    readonly targets: readonly string[];
+    readonly read: Validation | null;
+    readonly structured: Validation | null;
+    readonly fields: readonly Placed[];
+    readonly linked: boolean;
+    readonly sections: readonly Placed[];
+};
+export declare function assess(file: string, content: string, binary: boolean, model?: VerifiedModel, context?: Pick<ValidationContext, 'anyRoom'>): Assessment;
+export type Verdicts = {
+    add(assessment: Assessment, typeOf: (path: string) => string | undefined, binary: (path: string) => boolean): number;
+    verdict(): Validation;
+};
+export declare function verdicts(): Verdicts;
 export declare function validating(library: ReadonlyMap<string, string>, context?: ValidationContext, model?: VerifiedModel): Generator<ValidationStep, Validation, void>;
 export declare function validate(library: Library, context?: ValidationContext, model?: VerifiedModel): Validation;
+export {};

package/dist/mdruntime/adapter.d.ts

@@ -50,7 +50,7 @@ export type ListedConversation = {
     outcome: string | null;
     waiting: boolean;
 };
-export type ConversationAction = 'conversation.create' | 'conversation.send' | 'conversation.answer' | 'conversation.interrupt' | 'conversation.kill' | 'conversation.cancel' | 'conversation.delete' | 'conversation.history';
+export type ConversationAction = 'conversation.create' | 'conversation.send' | 'conversation.attach' | 'conversation.answer' | 'conversation.interrupt' | 'conversation.kill' | 'conversation.cancel' | 'conversation.delete' | 'conversation.history';
 export type ConversationMessage = {
     identity: string;
     turn: string;
@@ -255,7 +255,7 @@ export type ContractUnavailable = ProviderRefusal & {
 export type DiscoverResult = Discovery | TransportUncertainty | RevokedAuthorization | ContractUnavailable;
 export type PageToken = string;
 export type ChangeAuthor = {
-    kind: Open<'user' | 'site'>;
+    kind: Open<'user' | 'site' | 'inbox'>;
     id: string;
     name: string;
 };
@@ -274,9 +274,16 @@ export type BinaryFile = {
     mediaType: string;
     sha256: string;
 };
+export type HeldFile = {
+    readonly path: string;
+    readonly revision: string;
+};
 export type HeldContent = {
-    documents: Readonly<Record<string, string>>;
-    revisions: Readonly<Record<string, string>>;
+    files(after: string | null, limit: number): Promise<readonly HeldFile[]>;
+    contents(paths: readonly string[]): Promise<ReadonlyMap<string, {
+        readonly content: string;
+        readonly revision: string;
+    }>>;
 };
 export type BootstrapRequest = {
     locator: string;
@@ -297,6 +304,7 @@ export type BootstrapPage = {
     fileIds?: Readonly<Record<string, string>>;
     changes: Readonly<Record<string, HeadChange>>;
     binaryFiles: Readonly<Record<string, BinaryFile>>;
+    folders?: readonly string[];
     pageToken?: PageToken;
 };
 export type BootstrapResult = BootstrapPage | {
@@ -318,6 +326,8 @@ export type RefreshPage = {
     changes: Readonly<Record<string, HeadChange>>;
     binaryFiles: Readonly<Record<string, BinaryFile>>;
     removals: readonly string[];
+    folders?: readonly string[];
+    folderRemovals?: readonly string[];
     pageToken?: PageToken;
 };
 export type RefreshResult = {
@@ -328,6 +338,7 @@ export type RefreshResult = {
 export type MutationRequest = {
     locator: string;
     changeBatch: ChangeBatch;
+    file(localId: string): Promise<Blob>;
     upload?: unknown;
 };
 export type RetryableRefusal = ProviderRefusal & {
@@ -369,7 +380,7 @@ export type HistoryAuthor = {
     kind: 'user';
     id: string;
 } | {
-    kind: 'site';
+    kind: 'site' | 'inbox';
     id: string;
     name: string;
 };
@@ -408,15 +419,14 @@ export type BinaryRequest = {
     referrer: unknown;
 };
 export type ReferrerScope = {
-    kind: 'room';
     locator: string;
     path?: string;
-} | {
-    kind: 'conversations';
 };
 export type BinaryResult = {
     kind: 'binary';
-    blob: Blob;
+    body: ReadableStream<Uint8Array>;
+    mediaType: string;
+    sha256?: string;
 } | (ProviderRefusal & {
     kind: 'rejected';
 }) | AdapterFailure;
@@ -445,9 +455,8 @@ export type ActionResult = {
 export type HeldRoom = {
     locator: string;
     roomVersion: string;
-    documents: Readonly<Record<string, string>>;
-    revisions: Readonly<Record<string, string>>;
 };
+export type HeldRevisions = (locator: string, paths: readonly string[]) => Promise<ReadonlyMap<string, string>>;
 export type RoomStreamEvent = {
     kind: 'opened';
 } | {
@@ -482,11 +491,12 @@ export type RoomStream = {
     hold(rooms: readonly HeldRoom[]): void;
     reopen(): void;
     published(locator: string, roomVersion: string): void;
-    observe(notify: (event: RoomStreamEvent) => void, receipts: StreamReceipts): () => void;
+    observe(notify: (event: RoomStreamEvent) => void, receipts: StreamReceipts, revisions: HeldRevisions): () => void;
 };
 export type Adapter = {
     readonly localSaves?: true;
     readonly exhaustiveDiscovery?: true;
+    readonly roomTypes?: string;
     authorize(): Promise<Authorization>;
     discover(authorization: Authorization, scope?: DiscoveryScope): Promise<DiscoverResult>;
     bootstrap(authorization: Authorization, request: BootstrapRequest): Promise<BootstrapResult>;

package/dist/mdruntime/chain.d.ts

@@ -0,0 +1,10 @@
+import type { MdRuntimeClient } from './client.js';
+import type { DocumentQuery, DocumentResult, GroupQuery, GroupResult, PendingResult } from './query.js';
+type Rows = DocumentResult | GroupResult;
+export type WindowAnswer = Rows | PendingResult;
+export type WindowChain = {
+    want(count: number): void;
+    close(): void;
+};
+export declare function chainedWindows(runtime: MdRuntimeClient, query: DocumentQuery | GroupQuery, count: number, publish: (answers: readonly (WindowAnswer | null)[], settled: boolean) => void): WindowChain;
+export {};

package/dist/mdruntime/change-set.d.ts

@@ -1,10 +1,6 @@
-import { type Replica } from './replica.js';
-import { type Row } from './rows.js';
 export type DocumentChange = {
-    locator: string;
-    path: string;
-    before: readonly Row[];
-    after: readonly Row[];
+    readonly locator: string;
+    readonly path: string | null;
 };
 export type MessageChange = {
     conversation: string;
@@ -24,14 +20,14 @@ export type ChangeSet = {
     conversations: readonly string[];
 };
 type Changed = {
+    documents?: readonly string[] | null;
     drafts?: readonly string[];
     room?: boolean;
     queue?: boolean;
     presentation?: string;
 };
-export declare function changeSet(locator: string, before: Replica | null, after: Replica | null, changed?: Changed): ChangeSet;
-export declare function changing(locator: string, before: Replica | null, after: Replica | null, changed?: Changed): Generator<number, ChangeSet, void>;
-export declare function entering(locator: string, replica: Replica, paths: readonly string[]): ChangeSet;
+export declare function changeSet(locator: string, changed?: Changed): ChangeSet;
 export declare function conversationChangeSet(messages: readonly MessageChange[], conversations: readonly string[]): ChangeSet;
 export declare function mergeChangeSets(sets: readonly ChangeSet[]): ChangeSet;
+export declare function touches(set: ChangeSet, locator: string, path: string): boolean;
 export {};

package/dist/mdruntime/change.d.ts

@@ -30,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;

package/dist/mdruntime/client.d.ts

@@ -3,6 +3,7 @@ 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 { 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';
@@ -36,6 +37,7 @@ export type MdRuntimeClient = {
         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>;
@@ -59,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[]>>;
@@ -82,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,23 +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 collecting(text: Readonly<Record<string, string>>, composition: Composition, previous?: Collection): Generator<number, Collection, void>;
-export declare function passingFrontmatter(collection: Collection, path: string): Frontmatter | undefined;
+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: Readonly<Record<string, string>>, previous?: Readonly<Record<string, string>>): Generator<number, Refused | null, 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): Generator<number, Validation, void>;
-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>): Generator<number, ReadonlySet<string> | null, void>;
 export declare function available(composition: Composition): boolean;
-export declare function changedCleanly(next: Held, previous: Held & {
-    composition: Composition;
-}, composition: Composition): Generator<number, boolean, void>;
-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

@@ -8,13 +8,14 @@ import { type ChatDraftSurface, type ConversationAgent, type ConversationEntry,
 import { type WrittenBy } from './change.js';
 import type { Open } from './open.js';
 import { type BinaryReference } from './binary.js';
-import { type BinaryAnswer, type BinaryLinkAnswer, type CallResult, type HistoryAnswer, type QueueEntry, type Resolution } 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 RoomDraftParts, type RoomDraftWrite } from './room-draft.js';
 import { type SyncStatus } from './status.js';
 import { type RuntimeShell } from './durability.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[];
@@ -50,6 +51,7 @@ export type ConnectionRefusal = {
 export type MdRuntimeOptions = {
     adapter: Adapter;
     shell: RuntimeShell;
+    database: RuntimeDatabase;
     authorization?: Authorization;
     signal?: AbortSignal;
     recovery?: Recovery;
@@ -70,7 +72,7 @@ export type SavedParts = {
 };
 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>;
 };
@@ -80,9 +82,10 @@ export type PresentationSurface = {
     edit(app: string, members: Readonly<Record<string, unknown>>): Promise<void>;
 };
 export type BinaryFileSurface = {
-    read(room: string, path: string, revision?: string): Promise<BinaryAnswer>;
+    read(room: string, path: string, revision?: string): Promise<HeldBinaryAnswer>;
     link(room: string, path: string, revision?: string): Promise<BinaryLinkAnswer>;
-    readReference(reference: BinaryReference): Promise<BinaryAnswer>;
+    readReference(reference: BinaryReference): Promise<HeldBinaryAnswer>;
+    part(file: string, part: number): Promise<Uint8Array | null>;
 };
 export type HistoryQuery = {
     revision?: string;
@@ -107,10 +110,11 @@ export type MdRuntime = {
     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>>;