@agentshouse/app-bridge 0.1.0-c58a055eeaa71 → 0.1.0-c70153aac6ee3

package/dist/mdruntime/search.d.ts

@@ -0,0 +1,83 @@
+import type { ChangeSet } from './change-set.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 = {
+    text: string;
+    documents?: Filter;
+    conversations?: readonly string[];
+    limit?: number;
+};
+export type DocumentHit = {
+    room: string;
+    path: string;
+    type: string;
+    score: number;
+    matches: Readonly<Record<string, readonly DocumentPart[]>>;
+};
+export type MessageHit = {
+    conversation: string;
+    identity: string;
+    score: number;
+    matches: Readonly<Record<string, readonly Open<'text'>[]>>;
+};
+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;
+    type: string;
+    fields: Readonly<Record<string, unknown>>;
+    preamble: string;
+    sections: Readonly<Record<string, string>>;
+};
+export type SearchedMessage = {
+    conversation: string;
+    identity: string;
+    text: string;
+};
+export type SearchSource = {
+    room(room: string): readonly string[];
+    document(room: string, path: string): SearchedDocument | null;
+};
+export type SearchPlan = {
+    text: string;
+    documents: unknown;
+    conversations: readonly string[] | null;
+    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, 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

@@ -0,0 +1,26 @@
+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'>;
+    lastCompleted: string | null;
+    providerUnreachable: boolean;
+    attentionRequired: readonly AttentionEntry[];
+    reset: string | null;
+};
+export type CycleProgress = {
+    complete: boolean;
+    reachable: boolean;
+};
+export declare const STARTING: SyncStatus;
+export declare function transferring(status: SyncStatus): SyncStatus;
+export declare function saving(status: SyncStatus): SyncStatus;
+export declare function same(one: SyncStatus, other: SyncStatus): boolean;

package/dist/mdruntime/store.d.ts

@@ -0,0 +1,159 @@
+import type { ModelState } from './model.js';
+import type { Capability, HeadChange, Member, OperationScopes, ProviderLimit, ReplicaAdmission, TypedSelection } from './adapter.js';
+import type { AcceptedMessage, KeptReceipt } from './adapter.js';
+import type { ChangeBatch } from './change.js';
+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 = 25;
+export declare const AUTHORED_SCHEMA = 2;
+export type ReplicaRecord = {
+    locator: string;
+    name: string;
+    handle: string;
+    operations: OperationScopes;
+    replica: ReplicaAdmission;
+    model: ModelState;
+    typedSelection: TypedSelection | null;
+    selectionModel: ModelState;
+    providerOwnedPaths: readonly string[];
+    roomVersion: string;
+    transfer: string;
+    documents: Readonly<Record<string, string>>;
+    binaries: Readonly<Record<string, HeldBinary>>;
+    revisions: Readonly<Record<string, string>>;
+    changes: Readonly<Record<string, HeadChange>>;
+    written: Readonly<Record<string, string>>;
+};
+export type StagedLayer = Pick<ReplicaRecord, 'documents' | 'binaries' | 'revisions' | 'changes' | 'written'>;
+export type TransferRecord = {
+    locator: string;
+    transfer: string;
+    selection: string;
+    from: string;
+    last: string;
+    pageToken: string | null;
+    models: {
+        collection: ModelState;
+        selection: ModelState;
+    };
+};
+export type PendingState = {
+    readonly drafts: readonly SavedDraft[];
+    readonly submission: Submission;
+    readonly lost: boolean;
+    readonly upload?: unknown;
+    readonly accepted?: string;
+};
+export type TargetRecord = {
+    established: boolean;
+    search: boolean;
+};
+export type QueueRecord = {
+    locator: string;
+    pending: readonly {
+        batch: ChangeBatch;
+        state: PendingState;
+    }[];
+};
+export type PresentationRecord = {
+    app: string;
+    value: unknown;
+};
+export type HeldConversation = {
+    conversation: string;
+    read: string | null | undefined;
+    partial: boolean;
+};
+export type ConversationWrite = {
+    conversation: string;
+    messages: readonly AcceptedMessage[];
+    read?: {
+        at: string | null;
+        partial: boolean;
+    };
+};
+export type ChatSubmission = {
+    readonly operation: string;
+    readonly text: string;
+    readonly files: readonly ChatDraftFile[];
+    readonly turn: string | null;
+};
+export type ChatDraftRecord = {
+    conversation: string;
+    text: string;
+    files: readonly ChatDraftFile[];
+    revision: string;
+    submitted?: readonly ChatSubmission[];
+};
+export type RecordWrite = {
+    next: ReplicaRecord;
+    previous: ReplicaRecord | null;
+    stored?: StagedLayer;
+};
+export type AuthoredWrite = {
+    locator: string;
+    queue: readonly ChangeBatch[];
+    saved?: ReadonlyMap<string, readonly SavedDraft[]>;
+    roomDrafts?: readonly RoomDraftRecord[];
+    consumedRoomDrafts?: readonly string[];
+};
+export type RuntimeStore = {
+    all(): Promise<readonly ReplicaRecord[]>;
+    keepAuthored(input: AuthoredWrite): Promise<void>;
+    write(input: RecordWrite): Promise<void>;
+    revokeModels(records: readonly ReplicaRecord[]): Promise<void>;
+    lastCompleted(): Promise<string | null>;
+    complete(at: string): Promise<void>;
+    providerLimits(): Promise<readonly ProviderLimit[]>;
+    capabilities(): Promise<readonly Capability[]>;
+    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>;
+    keepUpload(locator: string, id: string, upload: unknown): Promise<void>;
+    roomDrafts(): Promise<readonly RoomDraftRecord[]>;
+    presentation(): Promise<readonly PresentationRecord[]>;
+    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>;
+    dropChatDraft(conversation: string): Promise<void>;
+    keepRoomDraft(record: RoomDraftRecord): Promise<void>;
+    discardRoomDraft(locator: string, path: string): Promise<void>;
+    fences(): Promise<readonly string[]>;
+    erase(locators: readonly string[]): Promise<void>;
+    discard(locator: string): Promise<void>;
+    transfers(): Promise<readonly TransferRecord[]>;
+    staged(record: TransferRecord): Promise<StagedLayer>;
+    stage(record: TransferRecord, page: StagedLayer): Promise<void>;
+    abandon(locator: string): Promise<void>;
+    receivedHeads(): Promise<readonly KeptReceipt[]>;
+    receivedParts(key: string, count: number): Promise<readonly unknown[]>;
+    keepReceived(key: string, head: unknown, part?: {
+        index: number;
+        value: unknown;
+    }): Promise<void>;
+    dropReceived(keys: readonly string[]): Promise<void>;
+    generation(): Promise<string | null>;
+    rememberGeneration(value: string): Promise<void>;
+    close(): void;
+};
+export declare function authoredHolder(): Promise<string | null>;
+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/transfer.d.ts

@@ -0,0 +1,9 @@
+import type { Refusal } from '../mdmodel/index.js';
+export type Unconfirmed = {
+    kind: 'unconfirmed';
+};
+export type Refused = {
+    kind: 'refused';
+    refusal: Refusal;
+};
+export declare const unconfirmed: Unconfirmed;

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

@@ -0,0 +1,104 @@
+import type { ConnectionRefusal } from './connection.js';
+import type { Described } from './failure.js';
+export type RuntimePort = {
+    postMessage(message: unknown): void;
+    addEventListener(type: 'message' | 'close', listener: (event: {
+        data?: unknown;
+    }) => void): void;
+    start(): void;
+};
+export type WireReach = 'within' | 'app' | 'runtime' | 'actions' | 'whole';
+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 retry: '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';
+};
+declare const TOPICS: {
+    readonly rooms: 'within';
+    readonly readiness: 'within';
+    readonly 'connection-refusal': 'runtime';
+    readonly 'storage-loss': 'runtime';
+    readonly 'deployment-facts': 'runtime';
+    readonly 'sync-status': 'within';
+    readonly 'service-mode': 'runtime';
+    readonly member: 'runtime';
+    readonly query: 'within';
+    readonly queue: 'within';
+    readonly 'room-drafts': 'within';
+    readonly presentation: 'app';
+    readonly conversation: 'within';
+    readonly conversations: 'within';
+    readonly agents: 'within';
+};
+export declare const WIRE_REACH: {
+    readonly members: Readonly<Record<string, WireReach>>;
+    readonly topics: Readonly<Record<string, WireReach>>;
+};
+export type WireMember = keyof typeof MEMBERS;
+export type WireTopic = keyof typeof TOPICS;
+export type WireRequest = {
+    kind: 'hello';
+} | {
+    kind: 'call';
+    id: number;
+    member: WireMember;
+    input: readonly unknown[];
+} | {
+    kind: 'observe';
+    id: number;
+    topic: WireTopic;
+    input: readonly unknown[];
+} | {
+    kind: 'stop';
+    id: number;
+};
+export type WireAnswer = {
+    kind: 'result';
+    id: number;
+    value: unknown;
+} | ({
+    kind: 'failure';
+    id: number;
+} & Described) | {
+    kind: 'event';
+    id: number;
+    value: unknown;
+} | {
+    kind: 'refusal';
+    refusal: ConnectionRefusal;
+} | {
+    kind: 'ended';
+};
+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;
+export declare function answer(message: unknown): WireAnswer | null;
+export {};

package/dist/test-host.d.ts

@@ -1,5 +1,5 @@
-import type { MdRuntimeClient } from '@agentshouse/mdruntime/client';
-import type { HouseAnalyticsChoice, HouseAppMessage, HouseExternalAnswer, HouseExternalRequest, HouseImageCopy, HouseNavigationMode, HouseRefusal, HouseSourceDownload, HouseSourceTop, HouseStatus, HouseTab } from './index.js';
+import type { MdRuntimeClient } from './mdruntime/client.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,13 +15,13 @@ 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;
     readonly status?: HouseStatus;
-    readonly images?: readonly (HouseImageCopy & {
-        readonly room: string;
-    })[];
     readonly sources?: readonly {
         readonly top: HouseSourceTop;
         readonly download: HouseSourceDownload;

package/dist/test-host.js

@@ -1,5 +1,5 @@
 const HOST_ORIGIN = 'https://house.invalid';
-const ADDRESS_MAX_CHARS = 1000;
+const ADDRESS_MAX_CHARS = 64 * 1024;
 function sameOriginPath(value) {
     if (typeof value !== 'string')
         return null;
@@ -29,6 +29,21 @@ function navigationRefused(address) {
         address,
     });
 }
+function followHeld(listeners, listener, held) {
+    let following = true;
+    queueMicrotask(() => {
+        if (!following)
+            return;
+        listeners.add(listener);
+        const value = held();
+        if (value !== null)
+            listener(value);
+    });
+    return () => {
+        following = false;
+        listeners.delete(listener);
+    };
+}
 export function createHouseBridgeTestHost(options = {}) {
     const navigations = [];
     const ceremonies = [];
@@ -42,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;
@@ -63,7 +79,17 @@ export function createHouseBridgeTestHost(options = {}) {
         });
     }
     function navigate(mode, asked) {
-        const target = sameOriginPath(asked);
+        let path = asked;
+        if (/^https?:\/\//i.test(asked)) {
+            try {
+                const target = new URL(asked);
+                path = target.origin === HOST_ORIGIN ? target.pathname + target.search + target.hash : '';
+            }
+            catch {
+                path = '';
+            }
+        }
+        const target = sameOriginPath(path);
         if (target === null)
             return Promise.reject(navigationRefused(asked));
         navigations.push({ mode, address: target });
@@ -76,10 +102,7 @@ export function createHouseBridgeTestHost(options = {}) {
         runtime,
         address: () => shown,
         onAddress(listener) {
-            addressListeners.add(listener);
-            return () => {
-                addressListeners.delete(listener);
-            };
+            return followHeld(addressListeners, listener, () => shown);
         },
         push: (asked) => navigate('push', asked),
         replace: (asked) => navigate('replace', asked),
@@ -96,17 +119,6 @@ export function createHouseBridgeTestHost(options = {}) {
         setTab(tab) {
             tabs.push(tab);
         },
-        readAttachment(room, attachment) {
-            const image = options.images?.find((entry) => entry.room === room && entry.attachment === attachment);
-            return Promise.resolve(image === undefined
-                ? null
-                : {
-                    attachment: image.attachment,
-                    copy: image.copy,
-                    name: image.name,
-                    media_type: image.media_type,
-                });
-        },
         sourceTop: (app) => Promise.resolve(options.sources?.find((entry) => entry.top.app_ref === app)?.top ?? null),
         sourceDownload: (app) => Promise.resolve(options.sources?.find((entry) => entry.top.app_ref === app)?.download ?? null),
         callExternal(request) {
@@ -117,10 +129,7 @@ export function createHouseBridgeTestHost(options = {}) {
         readSiteScreenshot: (site) => Promise.resolve(options.siteScreenshots?.[site] ?? null),
         status: () => seen,
         onStatus(listener) {
-            statusListeners.add(listener);
-            return () => {
-                statusListeners.delete(listener);
-            };
+            return followHeld(statusListeners, listener, () => seen);
         },
         messages(listener) {
             messageListeners.add(listener);
@@ -136,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);
@@ -161,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

@@ -39,10 +39,21 @@
   whether the page measures and the visitor's stored analytics choice, and
   `serviceMode`: `open`, `write-halted` while House refuses writes, so the
   App can stop retrying them, or `null` while the runtime holds no House
-  connection. Every status field is camelCase.
+  connection. Every status field is camelCase. `onStatus(listener)` and
+  `onAddress(listener)` hand a listener the status and the address the bridge
+  already holds, then each change.
   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.
@@ -82,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
@@ -104,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-c58a055eeaa71",
+  "version": "0.1.0-c70153aac6ee3",
   "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",
@@ -18,9 +18,6 @@
       "default": "./dist/test-host.js"
     }
   },
-  "dependencies": {
-    "@agentshouse/mdruntime": "0.1.0-c967d1ca66fee"
-  },
   "files": [
     "dist",
     "docs",