@agentshouse/app-bridge 0.1.0-cd8e22905148b → 0.1.0-cdb88c540d78b

package/dist/index.d.ts

@@ -110,6 +110,20 @@ export interface HouseBrowserRefused extends Error {
     readonly code: string;
     readonly retryable: boolean;
 }
+export interface HouseTrialWithheld {
+    readonly code: Open<'house_trial_withheld'>;
+    readonly retryable: true;
+}
+export type HouseTask = unknown;
+export type HouseActivation = Open<'committed' | 'abandoned'>;
+export interface HouseCooperation {
+    checkpoint(): Promise<void> | void;
+    persist(): Promise<void> | void;
+    capture(): Promise<HouseTask> | HouseTask;
+    restore(task: HouseTask | null): Promise<void> | void;
+    ready(): Promise<boolean> | boolean;
+    settle(activation: HouseActivation): void;
+}
 export interface HouseBridge {
     readonly runtime: Promise<HouseRuntime>;
     address(): string | null;
@@ -130,6 +144,7 @@ export interface HouseBridge {
     onStatus(listener: (status: HouseStatus) => void): () => void;
     messages(listener: (message: HouseAppMessage) => void): () => void;
     analyticsConsent(choice: HouseAnalyticsChoice): void;
+    cooperate(cooperation: HouseCooperation): () => void;
 }
 export interface HouseHeld {
     readonly houseBridge: HouseBridge;

package/dist/mdmodel/document.d.ts

@@ -1,6 +1,7 @@
 import { type Definition } from './definition.js';
-import type { ApplyResult, BodyResult, Change, Document, Link, LinkOccurrence, ParseResult } from './types.js';
+import type { ApplyResult, BodyResult, FrontmatterResult, Change, Document, Link, LinkOccurrence, ParseResult } from './types.js';
 import { type YamlMap } from './yaml.js';
+export declare function parseFrontmatter(content: string, file?: string): FrontmatterResult;
 export declare function parse(content: string, file?: string): ParseResult;
 export declare function relativize(document: Document, file: string, handle: string, definition?: Definition): ApplyResult;
 export declare function relativizeBody(body: string, file: string, handle: string): BodyResult;

package/dist/mdmodel/index.d.ts

@@ -3,7 +3,7 @@ export type { Actor, Condition, ConditionScope, ConditionTest, ConditionValue, C
 export { headingLines } from './blocks.js';
 export type { HeadingLine } from './blocks.js';
 export { divide } from './divide.js';
-export { apply, bodyLinks, fieldStart, linkOccurrences, links, parse, relativize, relativizeBody, relinkBody, serialize, } from './document.js';
+export { apply, bodyLinks, fieldStart, linkOccurrences, 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, target } from './paths.js';
 export { MARKDOWN_SYNTAX_PROFILE } from './profile.js';
@@ -11,8 +11,8 @@ 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, JsonType, PatternFacts, PointerFacts, SectionSpec, Shape, ValueFacts, } from './definition.js';
-export type { ApplyResult, BodyResult, Change, Division, DivisionContext, Document, Library, ModelVerification, Link, LinkOccurrence, ParseResult, Projection, ProjectionContext, Reference, Refusal, Span, Validation, ValidationContext, VerifiedModel, } from './types.js';
-export { validate, verify } from './validate.js';
+export type { ApplyResult, BodyResult, Change, Division, DivisionContext, Document, DocumentCheck, Frontmatter, FrontmatterResult, Library, ModelVerification, Link, LinkOccurrence, ParseResult, Projection, ProjectionContext, Reached, Reference, Refusal, Span, Validation, ValidationContext, VerifiedModel, } from './types.js';
+export { checkDocument, resolves, sectionReferences, validate, verify } from './validate.js';
 export { VERSION } from './version.js';
 export { equalValue, frontmatterValue } from './yaml.js';
 export type { FrontmatterValue } from './yaml.js';

package/dist/mdmodel/references.d.ts

@@ -1,3 +1,3 @@
 import { type Definition } from './definition.js';
-import type { Document, Reference } from './types.js';
-export declare function references(document: Document, definition: Definition): readonly Reference[];
+import type { Frontmatter, Reference } from './types.js';
+export declare function references(document: Pick<Frontmatter, 'fields'>, definition: Definition): readonly Reference[];

package/dist/mdmodel/types.d.ts

@@ -28,10 +28,12 @@ export type Extent = {
 export type Span = Extent & {
     readonly text: string;
 };
-export type Document = {
+export type Frontmatter = {
     readonly content: string;
     readonly type: string | undefined;
     readonly fields: Readonly<Record<string, unknown>>;
+};
+export type Document = Frontmatter & {
     readonly preamble: string;
     readonly sections: Readonly<Record<string, string>>;
 };
@@ -41,6 +43,18 @@ export type Refusal = {
     readonly location?: string;
     readonly referrers?: readonly string[];
 };
+export type Reached = {
+    readonly target: string | null;
+    readonly to: readonly string[];
+};
+export type DocumentCheck = {
+    readonly ok: false;
+} | {
+    readonly ok: true;
+    readonly type: string;
+    readonly typed: boolean;
+    readonly references: readonly Reached[];
+};
 export type Validation = {
     readonly verdict: 'accept';
 } | ({
@@ -60,6 +74,13 @@ export type Division = {
     readonly ok: false;
     readonly refusal: Refusal;
 };
+export type FrontmatterResult = {
+    readonly ok: true;
+    readonly frontmatter: Frontmatter;
+} | {
+    readonly ok: false;
+    readonly refusal: Refusal;
+};
 export type ParseResult = {
     readonly ok: true;
     readonly document: Document;

package/dist/mdmodel/validate.d.ts

@@ -1,3 +1,7 @@
-import type { Library, ModelVerification, Validation, ValidationContext, VerifiedModel } from './types.js';
+import { type Definition } from './definition.js';
+import type { DocumentCheck, Library, ModelVerification, Reached, Validation, ValidationContext, 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 checkDocument(file: string, content: string, model: VerifiedModel): DocumentCheck;
+export declare function sectionReferences(file: string, content: string, definition: Definition): readonly Reached[];
 export declare function validate(library: Library, context?: ValidationContext, model?: VerifiedModel): Validation;

package/dist/mdruntime/acquisition.d.ts

@@ -0,0 +1,13 @@
+export type RuntimeDemand = {
+    readonly whole: boolean;
+    readonly rooms: readonly string[];
+    readonly handles: readonly string[];
+    readonly conversations: boolean;
+};
+export declare const WHOLE_DEMAND: RuntimeDemand;
+export declare function demanded(demand: RuntimeDemand, room: {
+    readonly locator: string;
+    readonly handle: string;
+}): boolean;
+export declare function wider(next: RuntimeDemand, current: RuntimeDemand): boolean;
+export declare function narrower(next: RuntimeDemand, current: RuntimeDemand): boolean;

package/dist/mdruntime/adapter.d.ts

@@ -446,8 +446,12 @@ export type StreamReceipts = {
     }): Promise<void>;
     drop(keys: readonly string[]): Promise<void>;
 };
+export type AcquiredDemand = {
+    rooms: readonly string[];
+    conversations: boolean;
+};
 export type RoomStream = {
-    hold(rooms: readonly HeldRoom[]): void;
+    hold(rooms: readonly HeldRoom[], demand: AcquiredDemand | null): void;
     reopen(): void;
     published(locator: string, roomVersion: string): void;
     observe(notify: (event: RoomStreamEvent) => void, receipts: StreamReceipts): () => void;

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

@@ -9,6 +9,7 @@ export type DocumentChange = {
 export type MessageChange = {
     conversation: string;
     identity: string;
+    text: string | null;
 };
 export type ChangeSet = {
     documents: readonly DocumentChange[];
@@ -28,5 +29,6 @@ export declare function changeSet(locator: string, before: Replica | null, after
     queue?: boolean;
     presentation?: string;
 }): ChangeSet;
+export declare function entering(locator: string, replica: Replica, paths: readonly string[]): ChangeSet;
 export declare function conversationChangeSet(messages: readonly MessageChange[], conversations: readonly string[]): ChangeSet;
 export declare function mergeChangeSets(sets: readonly ChangeSet[]): ChangeSet;

package/dist/mdruntime/client.d.ts

@@ -4,16 +4,17 @@ import type { ChatDraft, ConversationAgent, ConversationEntry, ConversationOptio
 import { type Observation } from './observation.js';
 import type { BinaryReference } from './binary.js';
 import type { BinaryAnswer, CallResult, HistoryAnswer, Offline, QueueEntry } from './outcome.js';
-import type { DocumentQuery, DocumentResult, GroupQuery, GroupResult } from './query.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';
+import type { Readiness } from './readiness.js';
 import type { SyncStatus } from './status.js';
 import { type RuntimePort } from './wire.js';
 export type MdRuntimeClient = {
     rooms(): Promise<readonly AppRoom[]>;
     query: {
-        (query: DocumentQuery): Promise<DocumentResult>;
-        (query: GroupQuery): Promise<GroupResult>;
+        (query: DocumentQuery): Promise<DocumentResult | PendingResult>;
+        (query: GroupQuery): Promise<GroupResult | PendingResult>;
     };
     search(request: SearchRequest): Promise<SearchResult>;
     types(locator: string): Promise<RoomSchemas>;
@@ -52,16 +53,18 @@ export type MdRuntimeClient = {
     reached(locator: string, roomVersion: string, path?: string): Promise<boolean>;
     log(): Promise<string>;
     persistence(): Promise<boolean>;
+    retry(): Promise<void>;
     observe: {
         (topic: 'deployment-facts'): Promise<Observation<unknown>>;
         (topic: 'rooms'): Promise<Observation<readonly AppRoom[]>>;
+        (topic: 'readiness'): Promise<Observation<Readiness>>;
         (topic: 'connection-refusal'): Promise<Observation<ConnectionRefusal | null>>;
         (topic: 'storage-loss'): Promise<Observation<string | null>>;
         (topic: 'sync-status'): Promise<Observation<SyncStatus>>;
         (topic: 'service-mode'): Promise<Observation<ServiceMode>>;
         (topic: 'member'): Promise<Observation<Member | null>>;
-        (topic: 'query', query: DocumentQuery): Promise<Observation<DocumentResult>>;
-        (topic: 'query', query: GroupQuery): Promise<Observation<GroupResult>>;
+        (topic: 'query', query: DocumentQuery): Promise<Observation<DocumentResult | PendingResult>>;
+        (topic: 'query', query: GroupQuery): Promise<Observation<GroupResult | PendingResult>>;
         (topic: 'queue', locator: string): Promise<Observation<readonly QueueEntry[]>>;
         (topic: 'room-drafts'): Promise<Observation<readonly RoomDraft[]>>;
         (topic: 'presentation'): Promise<Observation<unknown>>;
@@ -75,4 +78,4 @@ export type MdRuntimeClient = {
 export declare function connectMdRuntime(port: RuntimePort): MdRuntimeClient;
 export declare function inTurn(client: MdRuntimeClient, work: () => Promise<void>): Promise<void>;
 export type { Observation } from './observation.js';
-export type { RuntimePort } from './wire.js';
+export { unanswered, type RuntimePort, type WireMember } from './wire.js';

package/dist/mdruntime/collection.d.ts

@@ -1,7 +1,9 @@
-import { type Document, type Validation } from '../mdmodel/index.js';
-import type { ModelState } from './model.js';
+import { type Document, type Frontmatter, type Validation } 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,8 +19,20 @@ export type Composition = {
 };
 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 passingDocument(collection: Collection, path: string): Document | undefined;
+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 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/connection.d.ts

@@ -1,6 +1,6 @@
 import { type TypesResult } from './model.js';
 import { type Observation } from './observation.js';
-import { type DocumentQuery, type DocumentResult, type GroupQuery, type GroupResult } from './query.js';
+import { type DocumentQuery, type DocumentResult, type GroupQuery, type GroupResult, type PendingResult } from './query.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';
@@ -13,6 +13,8 @@ import { type SaveRefusal } from './save.js';
 import { type RoomDraft, 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 NarrowedView, type PortReach, type RuntimeView } from './reach.js';
 export type AppTypedSelection = {
     roots: readonly string[];
@@ -83,8 +85,8 @@ export type MdRuntime = {
     loaded(): Promise<void>;
     rooms(): readonly AppRoom[];
     query: {
-        (query: DocumentQuery): Promise<DocumentResult>;
-        (query: GroupQuery): Promise<GroupResult>;
+        (query: DocumentQuery): Promise<DocumentResult | PendingResult>;
+        (query: GroupQuery): Promise<GroupResult | PendingResult>;
     };
     search(request: SearchRequest): Promise<SearchResult>;
     types(locator: string): RoomSchemas;
@@ -99,15 +101,17 @@ export type MdRuntime = {
     reached(locator: string, roomVersion: string, path?: string): boolean;
     log(): string;
     persistence(): boolean;
+    retry(): Promise<void>;
     observe: {
         (topic: 'rooms'): Promise<Observation<readonly AppRoom[]>>;
+        (topic: 'readiness'): Promise<Observation<Readiness>>;
         (topic: 'connection-refusal'): Promise<Observation<ConnectionRefusal | null>>;
         (topic: 'storage-loss'): Promise<Observation<string | null>>;
         (topic: 'sync-status'): Promise<Observation<SyncStatus>>;
         (topic: 'service-mode'): Promise<Observation<ServiceMode>>;
         (topic: 'member'): Promise<Observation<Member | null>>;
-        (topic: 'query', query: DocumentQuery): Promise<Observation<DocumentResult>>;
-        (topic: 'query', query: GroupQuery): Promise<Observation<GroupResult>>;
+        (topic: 'query', query: DocumentQuery): Promise<Observation<DocumentResult | PendingResult>>;
+        (topic: 'query', query: GroupQuery): Promise<Observation<GroupResult | PendingResult>>;
         (topic: 'queue', locator: string): Promise<Observation<readonly QueueEntry[]>>;
         (topic: 'room-drafts'): Promise<Observation<readonly RoomDraft[]>>;
         (topic: 'presentation', app: string): Promise<Observation<unknown>>;
@@ -117,11 +121,18 @@ export type MdRuntime = {
     };
     reauthorize(): Promise<void>;
 };
-export type RuntimeTopic = 'rooms' | 'connection-refusal' | 'storage-loss' | 'sync-status' | 'service-mode' | 'member' | 'query' | 'queue' | 'room-drafts' | 'presentation' | 'conversation' | 'conversations' | 'agents';
+export type RuntimeTopic = 'rooms' | 'readiness' | 'connection-refusal' | 'storage-loss' | 'sync-status' | 'service-mode' | 'member' | 'query' | 'queue' | 'room-drafts' | 'presentation' | 'conversation' | 'conversations' | 'agents';
+export type ReadinessPort = {
+    readonly target: string;
+    readonly code: CodeAvailability;
+    readonly capacity: CapacityCause | null;
+};
 export type ComposedRuntime = RuntimeView & {
     stop(): Promise<void>;
     lose(locators: readonly string[]): Promise<void>;
-    within(reach: PortReach | null): NarrowedView;
+    acquire(demand: RuntimeDemand): void;
+    persisted(answer: Persistence): void;
+    within(reach: PortReach | null, port: ReadinessPort): NarrowedView;
 };
 export declare function composeRuntime(options: MdRuntimeOptions): ComposedRuntime;
 export {};

package/dist/mdruntime/conversation.d.ts

@@ -3,8 +3,7 @@ import { type ChangeSet } from './change-set.js';
 import { type ChatDraftFile } from './file.js';
 import type { Open } from './open.js';
 import { type CallResult, type Offline } from './outcome.js';
-import type { DocumentResult } from './query.js';
-import type { SearchedMessage } from './search.js';
+import type { DocumentResult, PendingResult } from './query.js';
 import type { CycleProgress } from './status.js';
 import type { ChatDraftRecord, HeldConversation, RuntimeStore } from './store.js';
 export type ConversationState = Open<'working' | 'asking' | 'idle'>;
@@ -69,7 +68,7 @@ export type ChatDraftSurface = {
 };
 export type ConversationDependencies = {
     agents(): ConversationAgents | undefined;
-    documents(locator: string): Promise<DocumentResult>;
+    documents(agents: ConversationAgents): Promise<DocumentResult | PendingResult>;
     call(name: ConversationAction, input: unknown): Promise<CallResult>;
     durably<T>(work: (local: RuntimeStore) => Promise<T>): Promise<T>;
     stream(): ConversationStream | undefined;
@@ -87,6 +86,7 @@ export type ConversationStore = {
     catchUp(progress: CycleProgress): Promise<void>;
     resend(progress: CycleProgress): Promise<void>;
     current(): boolean;
+    known(): boolean;
     reconnected(): void;
     reopened(): void;
     watch(conversation: string, options: ConversationOptions, deliver: (view: ConversationView) => void): () => void;
@@ -94,8 +94,8 @@ export type ConversationStore = {
     watchAgents(deliver: (agents: readonly ConversationAgent[]) => void): () => void;
     changed(set: ChangeSet): void;
     receive(event: ConversationEvent): boolean;
-    messages(): readonly SearchedMessage[];
-    message(conversation: string, identity: string): SearchedMessage | null;
+    searchable(): readonly string[];
+    acquired(conversation: string): boolean;
     close(): void;
 };
 export declare function unheldView(conversation: string): ConversationView;

package/dist/mdruntime/durability.d.ts

@@ -1,8 +1,14 @@
+import type { Persistence } from './readiness.js';
+export type StorageEstimate = {
+    readonly usage: number;
+    readonly quota: number;
+};
 export type RuntimeShell = {
-    persistentStorage: boolean;
+    persistence: Persistence;
     generation: string | null;
     keepGeneration(value: string): void | Promise<void>;
     dropGeneration(): void | Promise<void>;
+    estimate?(): Promise<StorageEstimate | null>;
 };
 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/model.d.ts

@@ -52,4 +52,5 @@ export declare function definitionOf(state: ModelState, type: string | undefined
 export declare function modelTypes(state: ModelState): TypesResult;
 export declare function cached(state: ModelState): ModelState;
 export declare function sameModel(left: ModelIdentity, right: ModelIdentity): boolean;
+export declare function sameTyping(left: ModelState, right: ModelState): boolean;
 export declare function referenceField(facts: ValueFacts | undefined): boolean;

package/dist/mdruntime/observation.d.ts

@@ -1,4 +1,4 @@
-import type { QueryDocument, QueryGroup, QueryResult } from './query.js';
+import type { QueryCoverage, QueryDocument, QueryGroup, QueryResult } from './query.js';
 export type Observation<T> = {
     current(): T;
     subscribe(listener: (value: T) => void): () => void;
@@ -13,14 +13,17 @@ export type QueryChange = {
     changed: readonly (readonly [RowKey, QueryDocument | QueryGroup])[];
     removed: readonly RowKey[];
     order: readonly RowKey[] | null;
+    coverage?: QueryCoverage;
 };
+export type QueryMessage = KeyedResult | QueryChange;
 export type Observed = {
     observation: Observation<unknown>;
     receive(message: unknown): void;
     end(): void;
 };
 export declare function rowsOf(result: QueryResult): readonly (QueryDocument | QueryGroup)[];
-export declare function applied(keyed: KeyedResult, change: QueryChange): KeyedResult;
+export declare function whole(message: QueryMessage): message is KeyedResult;
+export declare function applied(keyed: KeyedResult, message: QueryMessage): KeyedResult;
 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>>;

package/dist/mdruntime/overlay.d.ts

@@ -22,4 +22,5 @@ export declare function sameBinary(left: HeldBinary | undefined, right: HeldBina
 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;

package/dist/mdruntime/query.d.ts

@@ -100,13 +100,38 @@ export type QueryGroup = {
     key: readonly unknown[];
     count: number;
 };
-export type DocumentResult = {
+export type CoveredRoom = {
+    room: string;
+    generation: string;
+    current: boolean;
+};
+export type QueryCoverage = {
+    rooms: readonly CoveredRoom[];
+    indexes: readonly string[];
+    overlay: readonly string[];
+};
+export type Awaits = 'acquisition' | 'preparation' | 'index';
+export type PendingRoom = {
+    room: string;
+    awaits: Awaits;
+};
+export type PendingResult = {
+    pending: readonly PendingRoom[];
+};
+export type DocumentRows = {
     documents: readonly QueryDocument[];
 };
-export type GroupResult = {
+export type GroupRows = {
     groups: readonly QueryGroup[];
 };
-export type QueryResult = DocumentResult | GroupResult;
+export type QueryRows = DocumentRows | GroupRows;
+export type DocumentResult = DocumentRows & {
+    coverage: QueryCoverage;
+};
+export type GroupResult = GroupRows & {
+    coverage: QueryCoverage;
+};
+export type QueryResult = DocumentResult | GroupResult | PendingResult;
 export type QueryErrorCode = 'invalid-query' | 'unknown-type' | 'unknown-field' | 'wrong-kind';
 export type RoomFacts = {
     locator: string;

package/dist/mdruntime/reach.d.ts

@@ -1,6 +1,7 @@
 import type { ReferrerScope } from './adapter.js';
-import type { MdRuntime, RuntimeTopic } from './connection.js';
+import type { MdRuntime, ReadinessPort, RuntimeTopic } from './connection.js';
 import type { Plan, PlanReach, QueryResult } from './query.js';
+import type { Readiness } from './readiness.js';
 import type { SearchResult } from './search.js';
 export type ReachedDocument = {
     readonly room: string;
@@ -19,12 +20,15 @@ export type RuntimeView = {
 };
 export type NarrowedView = RuntimeView & {
     narrow(reach: PortReach | null): void;
+    facts(port: ReadinessPort): void;
 };
 export type Reachable = RuntimeView & {
     plan(input: unknown, reach: PortReach | null): Plan;
     query(plan: Plan): Promise<QueryResult>;
     watchPlan(plan: Plan, deliver: (message: unknown) => void): () => void;
     search(input: unknown, reach: PortReach | null): Promise<SearchResult>;
+    searching(target: string): void;
+    watchReadiness(port: ReadinessPort, reach: PortReach | null, deliver: (readiness: Readiness) => void): () => void;
     referrerScope(referrer: unknown): ReferrerScope | null;
 };
 export declare function holds(reach: PortReach | null, room: string): boolean;
@@ -38,4 +42,4 @@ export declare function governs(reach: PortReach | null, room: {
     readonly selection: boolean;
 };
 export declare function planReach(reach: PortReach | null): PlanReach | null;
-export declare function narrowed(runtime: Reachable, given: PortReach | null): NarrowedView;
+export declare function narrowed(runtime: Reachable, given: PortReach | null, told: ReadinessPort): NarrowedView;

package/dist/mdruntime/readiness.d.ts

@@ -0,0 +1,52 @@
+import type { Open } from './open.js';
+export type CodeAvailability = Open<'stored' | 'absent'>;
+export type RoomPreparation = Open<'complete' | 'acquiring' | 'preparing' | 'indexing' | 'refused' | 'unadmitted'>;
+export type RoomCoverage = {
+    readonly room: string;
+    readonly state: RoomPreparation;
+};
+export type ConversationCoverage = Open<'complete' | 'acquiring' | 'indexing' | 'undeclared'>;
+export type SearchObligation = Open<'required' | 'unused'>;
+export type TargetCoverage = {
+    readonly complete: boolean;
+    readonly listed: boolean;
+    readonly rooms: readonly RoomCoverage[];
+    readonly conversations: ConversationCoverage;
+    readonly search: SearchObligation;
+};
+export type Persistence = Open<'granted' | 'denied' | 'unavailable'>;
+export type Durability = Open<'persistent' | 'best-effort'>;
+export type ConnectionAvailability = Open<'connected' | 'connecting' | 'unreachable'>;
+export type HouseOutcome = Open<'open' | 'write-halted' | 'refused'>;
+export type CapacityCause = {
+    readonly cause: Open<'insufficient-space' | 'quota-exceeded'>;
+    readonly needed: number | null;
+    readonly available: number | null;
+};
+export type RefusedRoom = {
+    readonly room: string;
+    readonly file: string;
+    readonly rule: string;
+    readonly location: string | null;
+};
+export type ReadinessStatus = Open<'preparing' | 'paused' | 'refused' | 'ready' | 'lost'>;
+export type Readiness = {
+    readonly status: ReadinessStatus;
+    readonly ready: boolean;
+    readonly usable: boolean;
+    readonly code: CodeAvailability;
+    readonly coverage: TargetCoverage;
+    readonly durability: Durability;
+    readonly persistence: Persistence;
+    readonly connection: ConnectionAvailability;
+    readonly house: HouseOutcome;
+    readonly capacity: CapacityCause | null;
+    readonly refused: readonly RefusedRoom[];
+    readonly lost: boolean;
+};
+export type ReadinessFacts = Omit<Readiness, 'status' | 'ready' | 'usable' | 'durability' | 'coverage'> & {
+    readonly coverage: Omit<TargetCoverage, 'complete'>;
+    readonly established: boolean;
+};
+export declare const SETTLED_ROOMS: ReadonlySet<string>;
+export declare function readinessOf(facts: ReadinessFacts): Readiness;

package/dist/mdruntime/replica.d.ts

@@ -31,7 +31,7 @@ type ReplayStep = {
 export declare function compositionOf(record: ReplicaRecord): Composition;
 export declare function confirmedOf(record: ReplicaRecord, previous?: ConfirmedLayer): ConfirmedLayer;
 export declare function sameMembership(record: ReplicaRecord, other: ReplicaRecord): boolean;
-export declare function readStaged(record: ReplicaRecord, previous?: ConfirmedLayer): Staged;
+export declare function readStaged(staged: ReplicaRecord, previous?: ConfirmedLayer): Staged;
 export declare function readReclassified(record: ReplicaRecord, previous: ConfirmedLayer): Staged | {
     kind: 'deferred';
 };

package/dist/mdruntime/rows.d.ts

@@ -1,4 +1,4 @@
-import { type Document } from '../mdmodel/index.js';
+import { type Frontmatter } from '../mdmodel/index.js';
 import type { HeadChange } from './adapter.js';
 import type { BinaryFileRecord } from './binary.js';
 import { type Composition } from './collection.js';
@@ -13,19 +13,10 @@ export type DocumentRow = {
     values: Fields;
     reached: Readonly<Record<string, readonly unknown[]>>;
     directories: readonly string[];
-    body: string;
+    text: string | null;
     change: HeadChange | null;
     binary: BinaryFileRecord | null;
 };
-export type BodyRow = {
-    key: string;
-    kind: 'body';
-    room: string;
-    path: string;
-    preamble: string;
-    sections: Readonly<Record<string, string>>;
-    markdown: string;
-};
 export type ReferenceRow = {
     key: string;
     kind: 'reference';
@@ -37,9 +28,9 @@ export type ReferenceRow = {
     path: string;
     type: string;
 };
-export type Row = DocumentRow | BodyRow | ReferenceRow;
+export type Row = DocumentRow | ReferenceRow;
 export declare function documentKey(room: string, path: string): string;
 export declare function roomOfKey(key: string): string;
 export declare function markdownPath(path: string): boolean;
-export declare function rowsOf(room: string, path: string, document: Document | null, composition: Composition, change: HeadChange | null, binary: BinaryFileRecord | null): readonly Row[];
+export declare function rowsOf(room: string, path: string, document: Frontmatter | null, composition: Composition, change: HeadChange | null, binary: BinaryFileRecord | null): readonly Row[];
 export {};

package/dist/mdruntime/save.d.ts

@@ -24,6 +24,11 @@ export type SaveInput = {
     bases: readonly Precondition[];
     queued?: ReadonlySet<string>;
     writtenBy?: WrittenBy;
+    clean?: {
+        text: Readonly<Record<string, string>>;
+        binaries: Readonly<Record<string, unknown>>;
+        composition: Composition;
+    };
 };
 export type BatchResult = {
     kind: 'batch';

package/dist/mdruntime/search.d.ts

@@ -1,5 +1,5 @@
 import type { ChangeSet } from './change-set.js';
-import { type Filter } from './query.js';
+import { type CoveredRoom, type Filter, type PendingRoom } from './query.js';
 import type { Open } from './open.js';
 export type DocumentPart = Open<'fields' | 'sections' | 'preamble' | 'path'>;
 export type SearchRequest = {
@@ -21,10 +21,26 @@ export type MessageHit = {
     score: number;
     matches: Readonly<Record<string, readonly Open<'text'>[]>>;
 };
-export type SearchResult = {
+export type SearchCoverage = {
+    rooms: readonly CoveredRoom[];
+    conversations: readonly string[];
+    index: string;
+    overlay: readonly string[];
+};
+export type PendingConversation = {
+    conversation: string;
+    awaits: 'index';
+};
+export type SearchPending = {
+    pending: readonly (PendingRoom | PendingConversation)[];
+};
+export type SearchHits = {
     documents: readonly DocumentHit[];
     messages: readonly MessageHit[];
 };
+export type SearchResult = (SearchHits & {
+    coverage: SearchCoverage;
+}) | SearchPending;
 export type SearchedDocument = {
     room: string;
     path: string;
@@ -39,10 +55,8 @@ export type SearchedMessage = {
     text: string;
 };
 export type SearchSource = {
-    documents(): readonly SearchedDocument[];
+    room(room: string): readonly string[];
     document(room: string, path: string): SearchedDocument | null;
-    messages(): readonly SearchedMessage[];
-    message(conversation: string, identity: string): SearchedMessage | null;
 };
 export type SearchPlan = {
     text: string;
@@ -51,11 +65,19 @@ export type SearchPlan = {
     limit: number | null;
 };
 export type SearchIndex = {
+    generation(): string;
+    rooms(): ReadonlySet<string>;
+    conversations(): ReadonlySet<string>;
+    indexRoom(room: string): Promise<void>;
+    indexMessages(conversation: string, messages: readonly SearchedMessage[], whole: boolean): void;
+    forget(rooms: readonly string[]): void;
     changed(set: ChangeSet): void;
+    changes(): number;
+    caughtUp(): Promise<void>;
     search(plan: SearchPlan, documents: readonly {
         room: string;
         path: string;
-    }[] | null): SearchResult;
+    }[] | null, conversations: readonly string[]): SearchHits;
 };
 export declare function searchPlanOf(input: unknown): SearchPlan;
 export declare function createSearchIndex(source: SearchSource): SearchIndex;

package/dist/mdruntime/shared.d.ts

@@ -0,0 +1,10 @@
+export type Paths<V> = Readonly<Record<string, V>>;
+type Weigh<V> = (key: string, value: V) => number;
+export declare function shared<V>(map: Paths<V>): Paths<V>;
+export declare function patched<V>(base: Paths<V>, set: Iterable<readonly [string, V]>, removed?: Iterable<string>): Paths<V>;
+export declare function tally<V>(map: Paths<V>, weigh: Weigh<V>): number;
+export declare function sizeOf<V>(map: Paths<V>): number;
+export declare function differing<V>(left: Paths<V>, right: Paths<V>, same?: (left: V, right: V) => boolean): ReadonlySet<string>;
+export declare function drafted<V>(base: Paths<V>): Record<string, V>;
+export declare function settled<V>(draft: Record<string, V>): Paths<V>;
+export {};

package/dist/mdruntime/status.d.ts

@@ -1,9 +1,13 @@
 import type { Open } from './open.js';
+import type { ProviderRefusal } from './adapter.js';
 import type { ReturnReason } from './room-draft.js';
 export type AttentionEntry = {
     room: string;
     path: string;
     returned: ReturnReason;
+} | {
+    room: string;
+    refusal: ProviderRefusal;
 };
 export type SyncStatus = {
     state: Open<'pending' | 'syncing' | 'synced'>;

package/dist/mdruntime/store.d.ts

@@ -6,7 +6,7 @@ import { type HeldBinary } from './overlay.js';
 import type { ChatDraftFile } from './file.js';
 import type { Submission } from './outcome.js';
 import type { RoomDraftRecord, SavedDraft } from './room-draft.js';
-export declare const STORE_SCHEMA = 24;
+export declare const STORE_SCHEMA = 25;
 export declare const AUTHORED_SCHEMA = 2;
 export type ReplicaRecord = {
     locator: string;
@@ -46,6 +46,10 @@ export type PendingState = {
     readonly upload?: unknown;
     readonly accepted?: string;
 };
+export type TargetRecord = {
+    established: boolean;
+    search: boolean;
+};
 export type QueueRecord = {
     locator: string;
     pending: readonly {
@@ -60,12 +64,15 @@ export type PresentationRecord = {
 export type HeldConversation = {
     conversation: string;
     read: string | null | undefined;
-    messages: readonly AcceptedMessage[];
+    partial: boolean;
 };
 export type ConversationWrite = {
     conversation: string;
     messages: readonly AcceptedMessage[];
-    read?: string | null;
+    read?: {
+        at: string | null;
+        partial: boolean;
+    };
 };
 export type ChatSubmission = {
     readonly operation: string;
@@ -104,6 +111,8 @@ export type RuntimeStore = {
     declare(limits: readonly ProviderLimit[], capabilities: readonly Capability[]): Promise<void>;
     member(): Promise<Member | null>;
     keepMember(member: Member | null): Promise<void>;
+    targets(): Promise<Readonly<Record<string, TargetRecord>>>;
+    keepTargets(targets: Readonly<Record<string, TargetRecord>>): Promise<void>;
     queues(): Promise<readonly QueueRecord[]>;
     submit(locator: string, id: string, submission: Submission, lost: boolean): Promise<void>;
     accept(locator: string, id: string, roomVersion: string): Promise<void>;
@@ -113,6 +122,10 @@ export type RuntimeStore = {
     present(record: PresentationRecord): Promise<void>;
     conversations(): Promise<readonly HeldConversation[]>;
     keepMessages(write: ConversationWrite): Promise<void>;
+    messageWindow(conversation: string, limit: number | undefined): Promise<AcceptedMessage[]>;
+    messagesAfter(conversation: string, identity: string | null): Promise<AcceptedMessage[]>;
+    messageIdentities(conversation: string): Promise<readonly string[]>;
+    turnArrived(conversation: string, turn: string): Promise<boolean>;
     dropConversations(conversations: readonly string[]): Promise<void>;
     chatDrafts(): Promise<readonly ChatDraftRecord[]>;
     keepChatDraft(record: ChatDraftRecord): Promise<void>;
@@ -142,4 +155,5 @@ export declare function authoredBy(holder: string): Promise<boolean>;
 export declare function authoredBinding(): Promise<string | null>;
 export declare function bindAuthored(binding: string): Promise<void>;
 export declare function removeRuntimeStore(holder?: string): Promise<boolean>;
+export declare function openDatabase(name: string, version: number, upgrade: (opening: IDBOpenDBRequest, oldVersion: number) => void): Promise<IDBDatabase>;
 export declare function openRuntimeStore(fenced: (locator: string) => boolean): Promise<RuntimeStore>;

package/dist/mdruntime/turn.d.ts

@@ -0,0 +1,6 @@
+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) => R): Later<R>;
+export declare function inUnits<T>(items: Iterable<T>, each: (item: T) => number): Later<void>;
+export declare function inChunks<T>(items: readonly T[], weigh: (item: T) => number, each: (chunk: readonly T[]) => void): Promise<void>;

package/dist/mdruntime/wire.d.ts

@@ -8,40 +8,140 @@ export type RuntimePort = {
     start(): void;
 };
 export type WireReach = 'within' | 'app' | 'runtime' | 'actions' | 'whole';
+export type WireEffect = 'read' | 'write' | 'action';
+export type WireCall = {
+    readonly reach: WireReach;
+    readonly effect: WireEffect;
+};
 declare const MEMBERS: {
-    readonly rooms: 'within';
-    readonly query: 'within';
-    readonly search: 'within';
-    readonly types: 'within';
-    readonly save: 'within';
-    readonly history: 'within';
-    readonly 'binaryFile.read': 'within';
-    readonly 'binaryFile.readReference': 'within';
-    readonly call: 'actions';
-    readonly reached: 'within';
-    readonly log: 'whole';
-    readonly persistence: 'runtime';
-    readonly reauthorize: 'runtime';
-    readonly 'roomDraft.list': 'within';
-    readonly 'roomDraft.read': 'within';
-    readonly 'roomDraft.write': 'within';
-    readonly 'roomDraft.discard': 'within';
-    readonly 'presentation.read': 'app';
-    readonly 'presentation.write': 'app';
-    readonly 'conversation.list': 'within';
-    readonly 'conversation.read': 'within';
-    readonly 'conversation.create': 'within';
-    readonly 'conversation.send': 'within';
-    readonly 'conversation.answer': 'within';
-    readonly 'conversation.interrupt': 'within';
-    readonly 'conversation.kill': 'within';
-    readonly 'conversation.cancel': 'within';
-    readonly 'conversation.delete': 'within';
-    readonly 'chatDraft.write': 'within';
-    readonly 'chatDraft.discard': 'within';
+    readonly rooms: {
+        readonly reach: 'within';
+        readonly effect: 'read';
+    };
+    readonly query: {
+        readonly reach: 'within';
+        readonly effect: 'read';
+    };
+    readonly search: {
+        readonly reach: 'within';
+        readonly effect: 'read';
+    };
+    readonly types: {
+        readonly reach: 'within';
+        readonly effect: 'read';
+    };
+    readonly save: {
+        readonly reach: 'within';
+        readonly effect: 'write';
+    };
+    readonly history: {
+        readonly reach: 'within';
+        readonly effect: 'read';
+    };
+    readonly 'binaryFile.read': {
+        readonly reach: 'within';
+        readonly effect: 'read';
+    };
+    readonly 'binaryFile.readReference': {
+        readonly reach: 'within';
+        readonly effect: 'read';
+    };
+    readonly call: {
+        readonly reach: 'actions';
+        readonly effect: 'action';
+    };
+    readonly reached: {
+        readonly reach: 'within';
+        readonly effect: 'read';
+    };
+    readonly log: {
+        readonly reach: 'whole';
+        readonly effect: 'read';
+    };
+    readonly persistence: {
+        readonly reach: 'runtime';
+        readonly effect: 'read';
+    };
+    readonly retry: {
+        readonly reach: 'runtime';
+        readonly effect: 'write';
+    };
+    readonly reauthorize: {
+        readonly reach: 'runtime';
+        readonly effect: 'write';
+    };
+    readonly 'roomDraft.list': {
+        readonly reach: 'within';
+        readonly effect: 'read';
+    };
+    readonly 'roomDraft.read': {
+        readonly reach: 'within';
+        readonly effect: 'read';
+    };
+    readonly 'roomDraft.write': {
+        readonly reach: 'within';
+        readonly effect: 'write';
+    };
+    readonly 'roomDraft.discard': {
+        readonly reach: 'within';
+        readonly effect: 'write';
+    };
+    readonly 'presentation.read': {
+        readonly reach: 'app';
+        readonly effect: 'read';
+    };
+    readonly 'presentation.write': {
+        readonly reach: 'app';
+        readonly effect: 'write';
+    };
+    readonly 'conversation.list': {
+        readonly reach: 'within';
+        readonly effect: 'read';
+    };
+    readonly 'conversation.read': {
+        readonly reach: 'within';
+        readonly effect: 'read';
+    };
+    readonly 'conversation.create': {
+        readonly reach: 'within';
+        readonly effect: 'action';
+    };
+    readonly 'conversation.send': {
+        readonly reach: 'within';
+        readonly effect: 'action';
+    };
+    readonly 'conversation.answer': {
+        readonly reach: 'within';
+        readonly effect: 'action';
+    };
+    readonly 'conversation.interrupt': {
+        readonly reach: 'within';
+        readonly effect: 'action';
+    };
+    readonly 'conversation.kill': {
+        readonly reach: 'within';
+        readonly effect: 'action';
+    };
+    readonly 'conversation.cancel': {
+        readonly reach: 'within';
+        readonly effect: 'action';
+    };
+    readonly 'conversation.delete': {
+        readonly reach: 'within';
+        readonly effect: 'action';
+    };
+    readonly 'chatDraft.write': {
+        readonly reach: 'within';
+        readonly effect: 'write';
+    };
+    readonly 'chatDraft.discard': {
+        readonly reach: 'within';
+        readonly effect: 'write';
+    };
 };
 declare const TOPICS: {
     readonly rooms: 'within';
+    readonly readiness: 'within';
     readonly 'connection-refusal': 'runtime';
     readonly 'storage-loss': 'runtime';
     readonly 'deployment-facts': 'runtime';
@@ -56,8 +156,8 @@ declare const TOPICS: {
     readonly conversations: 'within';
     readonly agents: 'within';
 };
-export declare const WIRE_REACH: {
-    readonly members: Readonly<Record<string, WireReach>>;
+export declare const WIRE: {
+    readonly members: Readonly<Record<string, WireCall>>;
     readonly topics: Readonly<Record<string, WireReach>>;
 };
 export type WireMember = keyof typeof MEMBERS;
@@ -95,6 +195,10 @@ export type WireAnswer = {
 } | {
     kind: 'ended';
 };
+export declare function unanswered(call: {
+    readonly id: number;
+    readonly member: WireMember;
+}): WireAnswer | null;
 export declare const AUTHORIZATION_ENDED = "the host authorization ended";
 export declare const PORT_CLOSED = "the port closed";
 export declare function request(message: unknown): WireRequest | null;

package/dist/test-host.d.ts

@@ -1,5 +1,5 @@
 import type { MdRuntimeClient } from './mdruntime/client.js';
-import type { HouseAnalyticsChoice, HouseAppMessage, HouseExternalAnswer, HouseExternalRequest, HouseNavigationMode, HouseRefusal, HouseSourceDownload, HouseSourceTop, HouseStatus, HouseTab } from './index.js';
+import type { HouseActivation, HouseAnalyticsChoice, HouseAppMessage, HouseExternalAnswer, HouseExternalRequest, HouseNavigationMode, HouseRefusal, HouseSourceDownload, HouseSourceTop, HouseStatus, HouseTab, HouseTask } from './index.js';
 export interface HouseBridgeNavigation {
     readonly mode: HouseNavigationMode;
     readonly address: string;
@@ -15,6 +15,9 @@ export interface HouseBridgeTestHost {
     publish(status: HouseStatus): void;
     message(message: HouseAppMessage): void;
     attachRuntime(runtime: MdRuntimeClient): void;
+    checkpoint(): Promise<HouseTask>;
+    restore(task: HouseTask | null): Promise<boolean>;
+    settle(activation: HouseActivation): void;
 }
 export interface HouseBridgeTestHostOptions {
     readonly address?: string;

package/dist/test-host.js

@@ -57,6 +57,7 @@ export function createHouseBridgeTestHost(options = {}) {
     let published = options.status ?? null;
     let shown = null;
     let seen = null;
+    let cooperation = null;
     let attached = () => { };
     const runtime = new Promise((resolve) => {
         attached = resolve;
@@ -144,7 +145,19 @@ export function createHouseBridgeTestHost(options = {}) {
             consents.push(choice);
             publish({ ...published, analytics: { measures: true, choice } });
         },
+        cooperate(given) {
+            cooperation = given;
+            return () => {
+                if (cooperation === given)
+                    cooperation = null;
+            };
+        },
     };
+    function cooperating() {
+        if (cooperation === null)
+            throw new Error('the App registered no cooperation');
+        return cooperation;
+    }
     Object.defineProperty(globalThis, 'houseBridge', { value: bridge, configurable: true });
     if (published !== null)
         publish(published);
@@ -169,5 +182,19 @@ export function createHouseBridgeTestHost(options = {}) {
         attachRuntime(client) {
             attached(client);
         },
+        async checkpoint() {
+            const held = cooperating();
+            await held.checkpoint();
+            await held.persist();
+            return JSON.parse(JSON.stringify((await held.capture()) ?? null));
+        },
+        async restore(task) {
+            const held = cooperating();
+            await held.restore(task);
+            return (await held.ready()) === true;
+        },
+        settle(activation) {
+            cooperating().settle(activation);
+        },
     };
 }

package/docs/families.md

@@ -45,6 +45,15 @@
   The App reports the visitor's choice with `analyticsConsent('accept')` or
   `analyticsConsent('decline')`; the shell hands it to House's analytics loader, and
   the choice never reaches House.
+- **Handoff** - when House hands its runtime over to a newer build, the App keeps
+  running, its `runtime` client and observations included: a call it makes
+  meanwhile waits for the newer runtime, however long that takes, and is
+  answered once, by it; each observation goes on with the newer runtime's
+  values; and the status and the address arrive again. A runtime that ended
+  before answering has its reads answered by the next one; since it may have
+  applied any other call, an act on House is answered the outcome
+  `transport-uncertainty`, and every other call, a Save or a draft write among
+  them, fails with the retryable code `transport-uncertainty`.
 - **Site image read** - given a Published Room and an original attachment
   reference, it answers the web copy's path and metadata, or `null` when no
   copy exists. The original bytes never cross this bridge at a Site.
@@ -84,6 +93,30 @@
   after its latest release, as a JPEG `Blob`, or `null` when House holds none
   or does not answer. A Site's own renderer reads none.
 
+- **Cooperation** - `cooperate({ checkpoint, persist, capture, restore,
+ready, settle })` lets House activate a newer release of the App while it
+  runs, keeping the User's task; the function it returns withdraws it.
+  Register it in the entry script, before the first draw, or House treats the
+  page as not cooperating and the newer release waits for the App's next
+  open. When a newer release is stored, House calls `checkpoint()`, which
+  resolves at the App's next safe checkpoint and may never resolve, then
+  `persist()`, which makes authored work durable, then `capture()`, which
+  answers the meaningful task the App owns, such as the selected record,
+  filters, cursor, selection and scroll position, as JSON of at most 65,536
+  characters; House keeps the address itself. In the newer release House
+  calls `restore(task)`, or `restore(null)` when it opens the release without
+  a task, then `ready()`, the App's own check that its local data and
+  capabilities work, and finally `settle('committed')` once the release is
+  active or `settle('abandoned')` when House returns to the release before
+  it, restoring the same task there. A release House opens already active is
+  settled `'committed'` at once, after `restore(task)` when House hands it a
+  task, and a cooperation registered after House settled is settled at its
+  registration. Until `settle('committed')` House fails the release's outside
+  calls at once, as offline, those of the workers it starts included, and
+  refuses its Saves, write acts and external calls with the retryable code
+  `house_trial_withheld`, so a start-up effect is not repeated; run start-up
+  effects after `settle('committed')`.
+
 ## The test host
 
 `createHouseBridgeTestHost(options)` plays House in one page: it installs a
@@ -106,4 +139,7 @@ given by Site identifier, answers every `install()` `'manual'`, as a browser
 with no install prompt does, answers every `notifications()` `'unavailable'`,
 as a browser without push does, settles every `setBadge`, delivers each App
 message `message({ from, body })` plays, and hands `bridge.runtime` the MD
-Runtime client `attachRuntime(client)` gives it.
+Runtime client `attachRuntime(client)` gives it. `checkpoint()` runs the
+registered cooperation's checkpoint, persist and capture and answers the task,
+`restore(task)` runs its restore and answers its readiness check, and
+`settle(activation)` hands it the outcome.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentshouse/app-bridge",
-  "version": "0.1.0-cd8e22905148b",
+  "version": "0.1.0-cdb88c540d78b",
   "description": "Types of the agents.house App bridge House hands every App: navigation, the tab title and icon, ceremonies, installation, notifications and the icon badge, status, Site image reads, App release code, App and Site screenshot reads, and App messages, with an accessor and an in-page test host.",
   "license": "MIT",
   "type": "module",