@agentshouse/app-bridge 0.1.0-cdef4b9ba1d57 → 0.1.0-cdf1bbaf17a3f

package/dist/calls.d.ts

@@ -16,18 +16,18 @@ export interface HouseMethods {
                 readonly user_name: string;
                 readonly entries: readonly {
                     readonly namespace: string;
-                    readonly read: 'mcp' | 'online' | 'local' | null;
+                    readonly level: 'search' | 'open' | 'keep' | null;
                     readonly operations: readonly ('write' | 'delete' | 'export' | 'manageAccess')[];
                     readonly sources: readonly {
                         readonly kind: 'direct' | 'inherited';
                         readonly namespace: string;
-                        readonly read: 'mcp' | 'online' | 'local' | null;
+                        readonly level: 'search' | 'open' | 'keep' | null;
                         readonly operations: readonly ('write' | 'delete' | 'export' | 'manageAccess')[];
                     }[];
                 }[];
                 readonly direct: readonly {
                     readonly namespace: string;
-                    readonly read: 'mcp' | 'online' | 'local' | null;
+                    readonly level: 'search' | 'open' | 'keep' | null;
                     readonly operations: readonly ('write' | 'delete' | 'export' | 'manageAccess')[];
                 }[];
                 readonly admitted_at: string | null;
@@ -346,7 +346,8 @@ export interface HouseMethods {
                 readonly owner: boolean;
                 readonly email?: string;
                 readonly since: string | null;
-                readonly access?: 'owner' | 'manage' | 'edit' | 'read';
+                readonly access?: 'owner' | 'manage' | 'edit' | 'keep' | 'open' | 'search';
+                readonly only_while_online?: true;
                 readonly member_document: string | null;
                 readonly schema_roles?: readonly string[];
             }[];
@@ -493,11 +494,7 @@ export interface HouseMethods {
                     readonly reach: 'selected';
                     readonly refs: readonly string[];
                 };
-                readonly accounts?: readonly {
-                    readonly id: string;
-                    readonly name: string;
-                    readonly origin: string;
-                }[];
+                readonly key_origins?: readonly string[];
                 readonly url: string;
             }[];
         };
@@ -610,16 +607,17 @@ export interface HouseMethods {
             readonly submitted: true;
         };
     };
-    readonly 'triggerOccurrence.list': {
+    readonly 'triggerEvent.list': {
         readonly params: {
             readonly room_ref: string;
         };
         readonly result: {
-            readonly occurrences: readonly {
+            readonly events: readonly {
                 readonly trigger: string;
                 readonly path?: string;
                 readonly moment?: string;
                 readonly missed?: 'skipped' | 'failed';
+                readonly code?: 'cap_reached';
                 readonly created_at: string;
                 readonly actions: readonly ({
                     readonly position: number;
@@ -628,7 +626,7 @@ export interface HouseMethods {
                 } | {
                     readonly position: number;
                     readonly outcome: 'no_target';
-                    readonly code: 'no_recipient' | 'routine_access_not_found' | 'routine_retired' | 'target_agent_unavailable';
+                    readonly code: 'no_recipient' | 'routine_access_not_found' | 'routine_retired' | 'target_agent_unavailable' | 'app_not_found' | 'app_function_not_found';
                 } | {
                     readonly position: number;
                     readonly outcome: 'requested';
@@ -678,12 +676,12 @@ export interface HouseMethods {
                     readonly position: number;
                     readonly outcome: 'refused';
                     readonly code: 'cap_reached';
-                    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' | 'folder_subscriptions';
+                    readonly cap: 'address_submissions' | 'writes' | 'push_addresses' | 'push_deliveries' | 'service_keys' | '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' | 'environment_functions' | 'folder_subscriptions';
                 } | {
                     readonly position: number;
                     readonly outcome: 'refused';
                     readonly code: 'cap_reached';
-                    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' | 'folder_subscriptions';
+                    readonly cap: 'address_submissions' | 'writes' | 'push_addresses' | 'push_deliveries' | 'service_keys' | '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' | 'environment_functions' | 'folder_subscriptions';
                     readonly retry_at: string;
                 } | {
                     readonly position: number;
@@ -693,6 +691,27 @@ export interface HouseMethods {
                     readonly position: number;
                     readonly outcome: 'failed';
                     readonly code: 'internal_error' | 'routine_request_not_started';
+                } | {
+                    readonly position: number;
+                    readonly outcome: 'failed';
+                    readonly code: 'function_failed';
+                    readonly error: string;
+                    readonly release: string;
+                    readonly final: true;
+                } | {
+                    readonly position: number;
+                    readonly outcome: 'failed';
+                    readonly code: 'function_not_started';
+                    readonly tries: number;
+                    readonly final?: true;
+                } | {
+                    readonly position: number;
+                    readonly outcome: 'running';
+                    readonly release: string;
+                } | {
+                    readonly position: number;
+                    readonly outcome: 'ran';
+                    readonly release: string;
                 } | {
                     readonly position: number;
                     readonly outcome: 'waiting';

package/dist/index.d.ts

@@ -80,8 +80,6 @@ export interface HouseExternalRequest {
     readonly headers?: Readonly<Record<string, string>>;
     readonly body?: string;
     readonly body_base64?: string;
-    readonly account?: string;
-    readonly slot?: string;
     readonly room_ref?: string;
 }
 export type HouseExternalAnswer = {
@@ -120,20 +118,8 @@ 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;
-    placed?(): Promise<void> | void;
-    settle(activation: HouseActivation): void;
+    placed(): Promise<void> | void;
 }
 export type HouseChatWidth = 'full' | '3/4' | '1/2' | '1/3';
 export interface HouseChatOpened {

package/dist/mdmodel/condition.d.ts

@@ -76,7 +76,11 @@ export type DateCondition = {
     readonly time_zone: string;
     readonly match?: ConditionTest;
 };
-export type Condition = DocumentCondition | ItemCondition | CronCondition | DateCondition;
+export type NotificationCondition = {
+    readonly on: 'notifications';
+    readonly match?: ConditionTest;
+};
+export type Condition = DocumentCondition | ItemCondition | CronCondition | DateCondition | NotificationCondition;
 export type FactKind = 'string' | 'number' | 'boolean' | 'date' | 'time' | 'enum' | 'reference';
 type Scalar = string | number | boolean;
 export type Fact = {
@@ -103,11 +107,13 @@ export type DocumentFacts = {
     readonly fields: Readonly<Record<string, Fact>>;
     readonly sections: readonly string[];
 };
-export declare const WRITE_DOORS: readonly ['browser', 'agent', 'client'];
+export declare const TEXT_FIELD = "/text";
+export declare const WRITE_DOORS: readonly ['browser', 'agent', 'client', 'function'];
 export type WriteDoor = (typeof WRITE_DOORS)[number];
 export type Actor = {
     readonly user?: string;
     readonly site?: string;
+    readonly app?: string;
     readonly door?: WriteDoor;
 };
 export type DocumentEvent = {
@@ -157,4 +163,5 @@ export declare function members(document: DocumentFacts, path: string): readonly
 export declare function holds(test: ConditionTest, document: DocumentFacts): Truth;
 export declare function fires(condition: DocumentCondition, event: DocumentEvent): boolean;
 export declare function itemFires(condition: ItemCondition, item: ItemFacts): boolean;
+export declare function notificationFires(condition: NotificationCondition, notification: DocumentFacts): boolean;
 export {};

package/dist/mdmodel/index.d.ts

@@ -1,5 +1,5 @@
-export { ACTOR_PATHS, actorOperators, changeFields, CONDITION_OPERATORS, dated, datePointers, DOCUMENT_PATHS, factKind, facts, fires, holds, instant, ITEM_PATHS, itemFires, itemKind, itemOperators, memberPointers, members, pointed, prosePaths, testOperators, valuedChange, WRITE_DOORS, } from './condition.js';
-export type { Actor, Condition, ConditionOperator, ConditionScope, ConditionTest, ConditionValue, CronCondition, DateCondition, DocumentCondition, DocumentEvent, DocumentFacts, Fact, FactKind, ItemCondition, ItemFacts, Resolved, WriteDoor, } from './condition.js';
+export { ACTOR_PATHS, actorOperators, changeFields, CONDITION_OPERATORS, dated, datePointers, DOCUMENT_PATHS, factKind, facts, fires, holds, instant, ITEM_PATHS, itemFires, itemKind, itemOperators, memberPointers, members, notificationFires, pointed, prosePaths, testOperators, TEXT_FIELD, valuedChange, WRITE_DOORS, } from './condition.js';
+export type { Actor, Condition, ConditionOperator, ConditionScope, ConditionTest, ConditionValue, CronCondition, DateCondition, DocumentCondition, DocumentEvent, DocumentFacts, Fact, FactKind, ItemCondition, ItemFacts, NotificationCondition, Resolved, WriteDoor, } from './condition.js';
 export { headingLines } from './blocks.js';
 export type { HeadingLine } from './blocks.js';
 export { divide } from './divide.js';

package/dist/mdruntime/adapter.d.ts

@@ -49,6 +49,7 @@ export type ListedConversation = {
     finished: string | null;
     outcome: string | null;
     waiting: boolean;
+    newest: string | null;
 };
 export type ConversationAction = 'conversation.create' | 'conversation.send' | 'conversation.answer' | 'conversation.interrupt' | 'conversation.kill' | 'conversation.cancel' | 'conversation.delete' | 'conversation.history';
 export type ConversationMessage = {
@@ -255,7 +256,7 @@ export type ContractUnavailable = ProviderRefusal & {
 export type DiscoverResult = Discovery | TransportUncertainty | RevokedAuthorization | ContractUnavailable;
 export type PageToken = string;
 export type ChangeAuthor = {
-    kind: Open<'user' | 'site' | 'inbox'>;
+    kind: Open<'user' | 'site' | 'inbox' | 'app'>;
     id: string;
     name: string;
 };
@@ -289,11 +290,10 @@ export type BootstrapRequest = {
     selection: string;
     pageToken?: PageToken;
     held?: HeldContent;
-    received?: Uint8Array;
     arriving?: (bytes: number) => void;
+    signal?: AbortSignal;
 };
 export type BootstrapInventory = {
-    readonly parts: number;
     readonly bytes: number;
 };
 export type RoomModels = {
@@ -310,8 +310,7 @@ export type BootstrapPage = {
     binaryFiles: Readonly<Record<string, BinaryFile>>;
     folders?: readonly string[];
     pageToken?: PageToken;
-    inventory?: BootstrapInventory;
-    received?: Uint8Array;
+    bytes?: number;
 };
 export type BootstrapResult = BootstrapPage | {
     kind: 'beyond-horizon';
@@ -386,7 +385,7 @@ export type HistoryAuthor = {
     kind: 'user';
     id: string;
 } | {
-    kind: 'site' | 'inbox';
+    kind: 'site' | 'inbox' | 'app';
     id: string;
     name: string;
 };
@@ -469,7 +468,13 @@ export type HeldRoom = {
     locator: string;
     roomVersion: string;
 };
-export type HeldRevisions = (locator: string, paths: readonly string[]) => Promise<ReadonlyMap<string, string>>;
+export type RoomChange = {
+    kind: 'room-change';
+    locator: string;
+    from: string;
+    roomVersion: string;
+    read(): Promise<RefreshPage>;
+};
 export type RoomStreamEvent = {
     kind: 'opened';
 } | {
@@ -482,29 +487,11 @@ export type RoomStreamEvent = {
 } | {
     kind: 'authority-changed';
     scope?: DiscoveryScope;
-} | {
-    kind: 'room-version';
-    locator: string;
-    roomVersion: string;
-};
-export type KeptReceipt = {
-    key: string;
-    head: unknown;
-};
-export type StreamReceipts = {
-    heads(): Promise<readonly KeptReceipt[]>;
-    parts(key: string, count: number): Promise<readonly unknown[]>;
-    keep(key: string, head: unknown, part?: {
-        index: number;
-        value: unknown;
-    }): Promise<void>;
-    drop(keys: readonly string[]): Promise<void>;
-};
+} | RoomChange;
 export type RoomStream = {
     hold(rooms: readonly HeldRoom[]): void;
     reopen(): void;
-    published(locator: string, roomVersion: string): void;
-    observe(notify: (event: RoomStreamEvent) => void, receipts: StreamReceipts, revisions: HeldRevisions): () => void;
+    observe(notify: (event: RoomStreamEvent) => void): () => void;
 };
 export type Adapter = {
     readonly localSaves?: true;
@@ -514,7 +501,7 @@ export type Adapter = {
     authorize(): Promise<Authorization>;
     discover(authorization: Authorization, scope?: DiscoveryScope): Promise<DiscoverResult>;
     bootstrap(authorization: Authorization, request: BootstrapRequest): Promise<BootstrapResult>;
-    refresh(authorization: Authorization, request: RefreshRequest): Promise<RefreshResult>;
+    refresh?(authorization: Authorization, request: RefreshRequest): Promise<RefreshResult>;
     mutate(authorization: Authorization, request: MutationRequest, keep: (upload: unknown) => Promise<void>): Promise<MutationResult>;
     history(authorization: Authorization, request: HistoryRequest): Promise<HistoryResult>;
     binary(authorization: Authorization, request: BinaryRequest): Promise<BinaryResult>;

package/dist/mdruntime/collection.d.ts

@@ -1,8 +1,6 @@
 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';
 export declare const MD_MODEL: MdModelIdentity;
 export type Collection = {
     text: Readonly<Record<string, string>>;
@@ -25,6 +23,5 @@ export declare function selected(composition: Composition, path: string): boolea
 export declare function governing(composition: Composition, path: string): ModelState;
 export declare function collectionOf(text: Readonly<Record<string, string>>, composition: Composition): Collection;
 export declare function documentsOf(collection: Collection): Generator<number, Iterable<readonly [string, Document]>, void>;
-export declare function unreadable(text: Paths<string>, paths?: Iterable<string> | null): Generator<number, Refused | null, void>;
 export declare function validRoot(root: unknown): root is string;
 export declare function available(composition: Composition): boolean;

package/dist/mdruntime/connection.d.ts

@@ -94,7 +94,7 @@ export type HistoryQuery = {
 };
 export type MdRuntime = {
     loaded(): Promise<void>;
-    rooms(): readonly AppRoom[];
+    rooms(): Promise<readonly AppRoom[]>;
     query: {
         (query: DocumentQuery): Promise<DocumentResult | PendingResult>;
         (query: GroupQuery): Promise<GroupResult | PendingResult>;
@@ -147,7 +147,6 @@ export type ComposedRuntime = RuntimeView & {
     stop(): Promise<void>;
     lose(locators: readonly string[]): Promise<void>;
     persisted(answer: Persistence): void;
-    shown(onScreen: boolean): void;
     within(reach: PortReach | null, port: ReadinessPort): NarrowedView;
 };
 export declare function composeRuntime(options: MdRuntimeOptions): ComposedRuntime;

package/dist/mdruntime/conversation.d.ts

@@ -1,4 +1,4 @@
-import type { ConversationAction, ConversationAgents, ConversationEvent, ConversationMessage, ConversationStream, ProcessCommand, SessionOption, TurnContext } from './adapter.js';
+import type { ConversationAction, ConversationAgents, ConversationEvent, ConversationMessage, ConversationStream, ListedConversation, ProcessCommand, SessionOption, TurnContext } from './adapter.js';
 import { type ChangeSet } from './change-set.js';
 import type { Open } from './open.js';
 import { type CallResult, type Offline } from './outcome.js';
@@ -83,6 +83,7 @@ export type ConversationDependencies = {
     stream(): ConversationStream | undefined;
     publish(set: ChangeSet): void;
     online(): boolean;
+    listed(): boolean;
     full(): boolean;
     closed(): boolean;
     unanswered(): void;
@@ -91,13 +92,14 @@ export type ConversationDependencies = {
 export type ConversationStore = {
     surface: ConversationSurface;
     chatDraft: ChatDraftSurface;
-    hydrate(held: readonly HeldConversation[], drafts: readonly ChatDraftRecord[]): void;
+    hydrate(held: readonly HeldConversation[], drafts: readonly ChatDraftRecord[], list: readonly ListedConversation[] | null): void;
     reconcile(): Promise<void>;
     catchUp(progress: CycleProgress): Promise<void>;
     resend(progress: CycleProgress): Promise<void>;
     current(): boolean;
     known(): boolean;
-    reconnected(): void;
+    learned(): void;
+    declared(): void;
     reopened(): void;
     lost(): void;
     watch(conversation: string, options: ConversationOptions, deliver: (view: ConversationView) => void): () => void;

package/dist/mdruntime/durability.d.ts

@@ -2,7 +2,6 @@ import type { Persistence } from './readiness.js';
 export type RuntimeShell = {
     persistence: Persistence;
     generation: string | null;
-    onScreen: boolean;
     keepGeneration(value: string): void | Promise<void>;
     dropGeneration(): void | Promise<void>;
     cleanUp?(): Promise<number>;

package/dist/mdruntime/media.d.ts

@@ -1,5 +1,5 @@
 import type { MdRuntimeClient } from './client.js';
-import type { ShownAnswer } from './outcome.js';
+import { type ShownAnswer } from './outcome.js';
 export declare const ROOM_MEDIA = "room-media";
 type Show = (room: string, path: string, revision?: string) => Promise<ShownAnswer>;
 export declare function shownBy(show: Show, client: MdRuntimeClient): MdRuntimeClient;

package/dist/mdruntime/model.d.ts

@@ -59,5 +59,4 @@ export declare function modelTypes(state: ModelState): TypesResult;
 export declare function storedModel(state: ModelState): StoredModel;
 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/outcome.d.ts

@@ -80,8 +80,5 @@ export type QueueEntry = {
     readonly batch: ChangeBatch;
 } & (Submission | {
     readonly state: 'local';
-} | {
-    readonly state: 'accepted';
-    readonly roomVersion: string;
 });
 export {};

package/dist/mdruntime/reach.d.ts

@@ -1,4 +1,4 @@
-import type { MdRuntime, ReadinessPort, RuntimeTopic } from './connection.js';
+import type { AppRoom, 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';
@@ -37,6 +37,7 @@ export type Reachable = RuntimeView & {
     lockedRooms(): readonly string[];
     watchLocks(notify: () => void): () => void;
     located(room: string, path: string, destination: string): ReachedDocument | null;
+    room(locator: string): AppRoom | undefined;
 };
 export declare function holds(reach: PortReach | null, room: string): boolean;
 export declare function governs(reach: PortReach | null, room: {

package/dist/mdruntime/readiness.d.ts

@@ -1,6 +1,6 @@
 import type { Open } from './open.js';
 export type CodeAvailability = Open<'stored' | 'absent'>;
-export type RoomPreparation = Open<'complete' | 'acquiring' | 'preparing' | 'refused' | 'unadmitted'>;
+export type RoomPreparation = Open<'complete' | 'acquiring' | 'preparing' | 'unadmitted'>;
 export type RoomCoverage = {
     readonly room: string;
     readonly state: RoomPreparation;
@@ -19,28 +19,17 @@ export type Durability = Open<'persistent' | 'best-effort'>;
 export type ConnectionAvailability = Open<'connected' | 'connecting' | 'unreachable'>;
 export type HouseOutcome = Open<'open' | 'write-halted' | 'refused'>;
 export type Space = Open<'full'>;
-export type RefusedRoom = {
-    readonly room: string;
-    readonly name: string;
-    readonly file: string;
-    readonly rule: string;
-    readonly location: string | null;
-};
-export type InstallationStep = Open<'listing' | 'downloading' | 'writing' | 'replaying'>;
-export type InstallationPause = Open<'hidden'>;
+export type InstallationStep = Open<'downloading' | 'writing' | 'replaying'>;
 export type InstallationAmount = {
     readonly done: number;
     readonly total: number;
 };
 export type Installation = {
     readonly step: InstallationStep | null;
-    readonly paused: InstallationPause | null;
     readonly rooms: InstallationAmount;
-    readonly parts: InstallationAmount;
     readonly bytes: InstallationAmount;
-    readonly received: InstallationAmount;
 };
-export type ReadinessStatus = Open<'preparing' | 'paused' | 'refused' | 'ready' | 'lost'>;
+export type ReadinessStatus = Open<'preparing' | 'paused' | 'ready' | 'lost'>;
 export type Readiness = {
     readonly status: ReadinessStatus;
     readonly ready: boolean;
@@ -53,7 +42,6 @@ export type Readiness = {
     readonly house: HouseOutcome;
     readonly space: Space | null;
     readonly installation: Installation;
-    readonly refused: readonly RefusedRoom[];
     readonly lost: boolean;
 };
 export type ReadinessFacts = Omit<Readiness, 'status' | 'ready' | 'usable' | 'durability' | 'coverage'> & {

package/dist/mdruntime/recovery.d.ts

@@ -21,4 +21,5 @@ export type Recovery = {
     retire(): Promise<void>;
 };
 export declare function retryDelay(tries: number, firstMs?: number, maxMs?: number): number;
+export declare function untilAnswered<T>(ask: () => Promise<T>, signal: AbortSignal, answered?: (answer: T) => boolean): Promise<T>;
 export declare function createRecovery(options?: RecoveryOptions): Recovery;

package/dist/mdruntime/replica.d.ts

@@ -15,7 +15,7 @@ export type ReplicaRecord = {
     readonly providerOwnedPaths: readonly string[];
     readonly roomVersion: string;
     readonly transfer: string;
-    readonly inventory: BootstrapInventory | null;
+    readonly inventory: BootstrapInventory;
     readonly key: number;
 };
 export type HeldReplica = {
@@ -34,7 +34,6 @@ export type Slice = Layer & {
     readonly held: ReadonlySet<string>;
 };
 export declare function compositionOf(record: Pick<ReplicaRecord, 'model' | 'typedSelection'>, builtIn: ModelState): Composition;
-export declare function sameMembership(record: Pick<ReplicaRecord, 'typedSelection'>, other: Pick<ReplicaRecord, 'typedSelection'>): boolean;
 export declare function storedRecord(record: ReplicaRecord): string;
 export declare function slicing(entries: readonly HeldEntry[], paths: Iterable<string>): Generator<number, Slice, void>;
 export declare function entryAt(layer: Layer & {

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

@@ -40,6 +40,7 @@ export type RoomDraftParts = {
     };
     readonly file?: {
         readonly blob: Blob;
+        readonly base?: string | null;
     };
 };
 export type HeldFile = {
@@ -112,7 +113,7 @@ export type RoomDraftWrite = {
 export declare function staleWrite(current: RoomDraft | null): RoomDraftWrite;
 export type ChangedPart = {
     readonly path: string;
-    readonly part: Open<'field' | 'section' | 'preamble' | 'markdown' | 'creation' | 'move' | 'removal' | 'file'>;
+    readonly part: Open<'field' | 'section' | 'preamble' | 'markdown' | 'move' | 'removal' | 'file'>;
     readonly name?: string;
 };
 export type RoomDraftRecord = {
@@ -132,7 +133,7 @@ export declare function held(current: HeldParts | undefined, parts: RoomDraftPar
 export declare function underneath(parts: HeldParts, path: string, visible: VisibleLayer | undefined): ChangedUnderneath;
 export declare function heldFile(blob: Blob, base: string | null): Promise<HeldFile>;
 export declare function binaryBase(visible: VisibleLayer | undefined, path: string): string | null;
-export declare function changedParts(path: string, report: ChangedUnderneath): readonly ChangedPart[];
+export declare function changedParts(path: string, parts: HeldParts, visible: VisibleLayer | undefined): readonly ChangedPart[];
 export type TextParts = {
     readonly fields?: Readonly<Record<string, {
         readonly value: unknown;
@@ -149,6 +150,20 @@ export declare function returnedInto(existing: HeldParts | undefined, returned:
 export declare function moveTarget(move: {
     readonly to: string;
 }): string;
+export declare function readSavedParts(named: readonly {
+    readonly path: string;
+    readonly parts: unknown;
+}[]): readonly {
+    readonly path: string;
+    readonly parts: RoomDraftParts;
+}[];
+export declare function partsChanges(named: readonly {
+    readonly path: string;
+    readonly parts: unknown;
+}[]): {
+    readonly changes: readonly Change[];
+    readonly preconditions: readonly Precondition[];
+};
 export declare function changesOf(path: string, parts: HeldParts): {
     changes: readonly Change[];
     bases: readonly Precondition[];

package/dist/mdruntime/status.d.ts

@@ -1,19 +1,20 @@
 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;
-} | {
+};
+export type UnsentChange = {
     room: string;
-    refusal: ProviderRefusal;
+    path: string;
 };
 export type SyncStatus = {
     state: Open<'pending' | 'syncing' | 'synced'>;
     lastCompleted: string | null;
     providerUnreachable: boolean;
     attentionRequired: readonly AttentionEntry[];
+    unsent: readonly UnsentChange[];
     reset: string | null;
 };
 export type CycleProgress = {

package/dist/mdruntime/store.d.ts

@@ -1,13 +1,13 @@
-import type { BootstrapInventory, Capability, KeptReceipt, Member, ProviderLimit } from './adapter.js';
+import type { BootstrapInventory, Capability, ListedConversation, Member, ProviderLimit } from './adapter.js';
 import type { ChangeBatch } from './change.js';
 import { type Composition } from './collection.js';
 import type { Plan } from './query.js';
 import type { ReplicaRecord } from './replica.js';
 import type { Submission } from './outcome.js';
 import type { RoomDraftRecord, SavedDraft } from './room-draft.js';
-import { type ModelState, type StoredModel } from './model.js';
+import type { ModelState, StoredModel } from './model.js';
 import type { SearchWindow } from './search.js';
-import type { CommittedWrite, ConversationWrite, CountedRoom, HeldConversation, HeldEntry, KeptPart, MessageWindow, QueryAnswer, QueryRoom, Referrer, RoomCommit, RuntimeDatabase, SearchAsk, StoredEntry, StoredFile, TypedEntry, View, Walked } from './tables.js';
+import type { CommittedWrite, ConversationWrite, CountedRoom, HeldConversation, HeldEntry, MessageWindow, QueryAnswer, QueryRoom, Referrer, RoomCommit, RuntimeDatabase, SearchAsk, StoredEntry, StoredFile, TypedEntry, View } from './tables.js';
 export type { ConversationWrite, HeldConversation, MessageWindow } from './tables.js';
 export type TransferRecord = {
     readonly locator: string;
@@ -15,8 +15,6 @@ export type TransferRecord = {
     readonly selection: string;
     readonly from: string;
     readonly last: string;
-    readonly pageToken: string | null;
-    readonly inventory: BootstrapInventory | null;
     readonly done: BootstrapInventory;
     readonly models: {
         readonly collection: ModelState;
@@ -26,17 +24,11 @@ export type TransferRecord = {
 export type StoredReplica = Omit<ReplicaRecord, 'model'> & {
     readonly model: StoredModel;
 };
-export type StoredTransfer = Omit<TransferRecord, 'models'> & {
-    readonly models: {
-        readonly collection: StoredModel;
-    };
-};
 export type PendingState = {
     readonly drafts: readonly SavedDraft[];
     readonly submission: Submission;
     readonly lost: boolean;
     readonly upload?: unknown;
-    readonly accepted?: string;
 };
 export type TargetRecord = {
     established: boolean;
@@ -76,10 +68,6 @@ export type AuthoredWrite = {
     saved?: ReadonlyMap<string, readonly SavedDraft[]>;
     roomDrafts?: readonly RoomDraftRecord[];
     consumedRoomDrafts?: readonly string[];
-    accepted?: readonly {
-        readonly id: string;
-        readonly roomVersion: string;
-    }[];
 };
 export type StagedPage = {
     readonly entries: readonly StoredEntry[];
@@ -91,8 +79,6 @@ export type RefreshedPage = StagedPage & {
 };
 export type Opened = {
     readonly rooms: ReadonlyMap<string, StoredReplica>;
-    readonly transfers: ReadonlyMap<string, StoredTransfer>;
-    readonly kept: ReadonlyMap<string, ReadonlyMap<string, number>>;
     readonly unindexed: ReadonlySet<number>;
     readonly overlaid: ReadonlyMap<number, ReadonlySet<string>>;
     readonly erasing: boolean;
@@ -103,6 +89,7 @@ export type Opened = {
     readonly member: Member | null;
     readonly targets: Readonly<Record<string, TargetRecord>>;
     readonly presentation: readonly PresentationRecord[];
+    readonly conversationList: readonly ListedConversation[] | null;
 };
 export type Commit = {
     readonly rooms: readonly RoomCommit[];
@@ -119,7 +106,6 @@ export type RuntimeStore = {
     entries(key: number, view: View, paths: readonly string[]): Promise<readonly HeldEntry[]>;
     typed(key: number, view: View, paths: readonly string[]): Promise<readonly TypedEntry[]>;
     referrers(key: number, view: View, targets: readonly string[], kinds: readonly string[]): Promise<readonly Referrer[]>;
-    walk(key: number, view: View, after: string | null, bytes: number): Promise<Walked>;
     files(key: number, view: View, after: string | null, limit: number): Promise<readonly {
         readonly path: string;
         readonly revision: string;
@@ -127,17 +113,18 @@ export type RuntimeStore = {
     folders(key: number, view: View, paths: readonly string[]): Promise<readonly string[]>;
     typedWithin(key: number, view: View, roots: readonly string[], within: boolean): Promise<boolean>;
     search(ask: SearchAsk): Promise<SearchWindow>;
-    stage(record: TransferRecord, composition: Composition, page: StagedPage, written?: string): Promise<number | null>;
-    transferPart(locator: string, token: string): Promise<Uint8Array | null>;
-    keepParts(parts: readonly KeptPart[]): Promise<void>;
+    stage(record: TransferRecord, composition: Composition, page: StagedPage): Promise<number | null>;
     refresh(key: number, composition: Composition, page: RefreshedPage): Promise<void>;
     unrefresh(key: number): Promise<void>;
     commit(commit: Commit): Promise<CommittedWrite>;
     fence(locators: readonly string[]): Promise<void>;
     erase(locator: string | null, limit: number): Promise<boolean>;
-    abandon(locator: string, kept?: boolean): Promise<number | null>;
+    abandon(locator: string): Promise<void>;
     release(key: number): Promise<void>;
-    rederive(key: number, composition: Composition, bytes: number): Promise<boolean>;
+    rederive(key: number, composition: Composition, bytes: number, ms: number, floor: number): Promise<{
+        readonly done: boolean;
+        readonly text: number;
+    }>;
     fact(name: string, value: unknown): Promise<void>;
     queues(): Promise<readonly QueueRecord[]>;
     submit(locator: string, id: string, submission: Submission, lost: boolean): Promise<void>;
@@ -159,13 +146,6 @@ export type RuntimeStore = {
     keepRoomDraft(record: RoomDraftRecord, files: readonly StoredFile[]): Promise<void>;
     discardRoomDraft(locator: string, path: string): Promise<void>;
     fences(): Promise<readonly string[]>;
-    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>;
     file(key: string, type: string): Promise<Blob>;

package/dist/mdruntime/stored.d.ts

@@ -42,16 +42,6 @@ export type ReplicaOpened = {
         readonly key: number;
         readonly record: string;
     }[];
-    readonly transfers: readonly {
-        readonly locator: string;
-        readonly key: number;
-        readonly record: string;
-    }[];
-    readonly kept: readonly {
-        readonly locator: string;
-        readonly token: string;
-        readonly bytes: number;
-    }[];
     readonly keys: readonly HeldKey[];
     readonly facts: Readonly<Record<string, string>>;
     readonly presentation: readonly {
@@ -96,20 +86,14 @@ export type CountedRoom = {
     readonly key: number;
     readonly roots: readonly string[];
 };
-export type Walked = {
-    readonly entries: readonly HeldEntry[];
-    readonly next: string | null;
-};
 export declare function entered(connection: Connection, locator: string, composition: Composition, rows: readonly StoredEntry[]): number;
 export declare function stage(connection: Connection, request: {
     readonly locator: string;
     readonly transfer: string;
-    readonly record: string;
     readonly key: number | null;
     readonly fingerprint: string;
     readonly entries: readonly StoredEntry[];
     readonly folders: readonly string[];
-    readonly written?: string;
 }): number;
 export declare function refreshing(connection: Connection, request: {
     readonly key: number;
@@ -123,30 +107,23 @@ export declare function unrefresh(connection: Connection, key: number): null;
 export declare function counts(connection: Connection, rooms: readonly CountedRoom[]): number[];
 export declare function commit(connection: Connection, rooms: readonly RoomCommit[]): Committed;
 export declare function fenceRooms(connection: Connection, locators: readonly string[]): null;
-export declare function abandon(connection: Connection, locator: string, kept: boolean): number | null;
+export declare function abandon(connection: Connection, locator: string): null;
 export declare function release(connection: Connection, key: number): null;
 export declare function erase(connection: Connection, locator: string | null, limit: number): {
     readonly remaining: boolean;
 };
-export declare function rederive(connection: Connection, key: number, composed: Composed, bytes: number): {
+export declare function rederive(connection: Connection, key: number, composed: Composed, bytes: number, ms: number, floor: number): {
     readonly done: boolean;
+    readonly text: number;
 };
 export declare function entries(connection: Connection, key: number, view: View, list: readonly string[]): HeldEntry[];
 export declare function typed(connection: Connection, key: number, view: View, list: readonly string[]): TypedEntry[];
 export declare function referrers(connection: Connection, key: number, view: View, targets: readonly string[], kinds: readonly string[]): Referrer[];
-export declare function walk(connection: Connection, key: number, view: View, after: string | null, bytes: number): Walked;
 export declare function files(connection: Connection, key: number, view: View, after: string | null, limit: number): {
     readonly path: string;
     readonly revision: string;
 }[];
 export declare function folders(connection: Connection, key: number, view: View, list: readonly string[]): string[];
 export declare function typedWithin(connection: Connection, key: number, view: View, roots: readonly string[], within: boolean): boolean;
-export declare function transferPart(connection: Connection, locator: string, token: string): Uint8Array | null;
-export type KeptPart = {
-    readonly locator: string;
-    readonly token: string;
-    readonly part: Uint8Array;
-};
-export declare function keepParts(connection: Connection, parts: readonly KeptPart[]): null;
 export declare function opened(connection: Connection): ReplicaOpened;
 export declare function ended(connection: Connection): void;

package/dist/mdruntime/tables.d.ts

@@ -1,12 +1,11 @@
 import { type QueryAnswer, type QueryRoom } from './compile.js';
-import type { KeptReceipt } from './adapter.js';
 import type { Composed } from './collection.js';
 import { type SearchAsk } from './fulltext.js';
 import { type ConversationWrite, type HeldConversation, type MessageWindow } from './messages.js';
 import type { Plan } from './query.js';
 import type { SearchWindow } from './search.js';
-import { type Committed, type CountedRoom, type HeldEntry, type KeptPart, type ReplicaOpened, type Referrer, type RoomCommit, type StoredEntry, type TypedEntry, type View, type Walked } from './stored.js';
-export type { Committed, CountedRoom, HeldEntry, KeptPart, OverlayEntry, ReplicaOpened, Referrer, RoomCommit, StoredEntry, TypedEntry, View, Walked, } from './stored.js';
+import { type Committed, type CountedRoom, type HeldEntry, type ReplicaOpened, type Referrer, type RoomCommit, type StoredEntry, type TypedEntry, type View } from './stored.js';
+export type { Committed, CountedRoom, HeldEntry, OverlayEntry, ReplicaOpened, Referrer, RoomCommit, StoredEntry, TypedEntry, View, } from './stored.js';
 export type { QueryAnswer, QueryRoom } from './compile.js';
 export type { SearchAsk } from './fulltext.js';
 export type { ConversationWrite, HeldConversation, MessageWindow } from './messages.js';
@@ -78,10 +77,6 @@ export type AuthoredRows = {
         readonly path: string;
     })[];
     readonly consumedRoomDrafts?: readonly string[];
-    readonly amendments?: readonly {
-        readonly id: string;
-        readonly amendment: string;
-    }[];
 };
 export type HeldQueues = {
     readonly queues: readonly {
@@ -182,12 +177,6 @@ export interface RuntimeRequests {
         readonly targets: readonly string[];
         readonly kinds: readonly string[];
     }, readonly Referrer[]>;
-    readonly 'replica.walk': Asked<{
-        readonly key: number;
-        readonly view: View;
-        readonly after: string | null;
-        readonly bytes: number;
-    }, Walked>;
     readonly 'replica.files': Asked<{
         readonly key: number;
         readonly view: View;
@@ -212,28 +201,14 @@ export interface RuntimeRequests {
         readonly rooms: readonly CountedRoom[];
     }, readonly number[]>;
     readonly 'replica.search': Asked<SearchAsk, SearchWindow>;
-    readonly 'replica.received': Asked<Nothing, readonly KeptReceipt[]>;
-    readonly 'replica.receivedParts': Asked<{
-        readonly key: string;
-        readonly count: number;
-    }, readonly unknown[]>;
     readonly 'replica.stage': Asked<{
         readonly locator: string;
         readonly transfer: string;
-        readonly record: string;
         readonly key: number | null;
         readonly fingerprint: string;
         readonly entries: readonly StoredEntry[];
         readonly folders: readonly string[];
-        readonly written?: string;
     }, number | null>;
-    readonly 'replica.transferPart': Asked<{
-        readonly locator: string;
-        readonly token: string;
-    }, Uint8Array | null>;
-    readonly 'replica.keepParts': Asked<{
-        readonly parts: readonly KeptPart[];
-    }, null>;
     readonly 'replica.refresh': Asked<{
         readonly key: number;
         readonly composed: Composed;
@@ -260,8 +235,7 @@ export interface RuntimeRequests {
     }>;
     readonly 'replica.abandon': Asked<{
         readonly locator: string;
-        readonly kept: boolean;
-    }, number | null>;
+    }, null>;
     readonly 'replica.release': Asked<{
         readonly key: number;
     }, null>;
@@ -269,8 +243,11 @@ export interface RuntimeRequests {
         readonly key: number;
         readonly composed: Composed;
         readonly bytes: number;
+        readonly ms: number;
+        readonly floor: number;
     }, {
         readonly done: boolean;
+        readonly text: number;
     }>;
     readonly 'replica.fact': Asked<{
         readonly name: string;
@@ -280,17 +257,6 @@ export interface RuntimeRequests {
         readonly app: string;
         readonly value: string;
     }, null>;
-    readonly 'replica.receive': Asked<{
-        readonly key: string;
-        readonly head: string;
-        readonly part?: {
-            readonly index: number;
-            readonly value: string;
-        };
-    }, null>;
-    readonly 'replica.unreceive': Asked<{
-        readonly keys: readonly string[];
-    }, null>;
     readonly 'opened.find': Asked<{
         readonly locator: string;
         readonly path: string;

package/dist/test-host.d.ts

@@ -1,5 +1,5 @@
 import type { MdRuntimeClient } from './mdruntime/client.js';
-import type { HouseActivation, HouseAnalyticsChoice, HouseAppMessage, HouseChatOptions, HouseExternalAnswer, HouseExternalRequest, HouseNavigationMode, HouseRefusal, HouseSourceDownload, HouseSourceTop, HouseStatus, HouseTab, HouseTask } from './index.js';
+import type { HouseAnalyticsChoice, HouseAppMessage, HouseChatOptions, HouseExternalAnswer, HouseExternalRequest, HouseNavigationMode, HouseRefusal, HouseSourceDownload, HouseSourceTop, HouseStatus, HouseTab } from './index.js';
 export interface HouseBridgeNavigation {
     readonly mode: HouseNavigationMode;
     readonly address: string;
@@ -21,9 +21,6 @@ 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

@@ -58,7 +58,6 @@ 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;
@@ -160,19 +159,8 @@ export function createHouseBridgeTestHost(options = {}) {
             consents.push(choice);
             publish({ ...published, analytics: { measures: true, choice } });
         },
-        cooperate(given) {
-            cooperation = given;
-            return () => {
-                if (cooperation === given)
-                    cooperation = null;
-            };
-        },
+        cooperate: () => () => { },
     };
-    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);
@@ -198,19 +186,5 @@ 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

@@ -13,8 +13,7 @@
   absolute path, carries its current address as the return target, and the page
   returns there when it completes. An App names an address House gave it in a
   reading and composes one only for `/bind/<app_ref>`, where the User binds
-  its Rooms and connects its account slots, with `?slot=<name>` to open at one
-  slot.
+  its Rooms, with `?slot=<name>` to open at one slot.
 - **Installation** - `install()` offers the page as a Home-screen app. Where the
   browser has an install prompt ready the shell shows it and the call resolves
   `'accepted'` or `'dismissed'` with the User's choice, spending that prompt;
@@ -47,15 +46,19 @@
   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`.
+- **Releases and builds** - an open App keeps the release it loaded: a newer
+  release, or a newer House build, takes effect at the App's next load, offline
+  too once the browser stored it. When one tab loads a newer House build, the
+  other House tabs reload into it; Room Drafts, chat drafts and unsent changes
+  survive the reload.
+- **A runtime that ends** - when the browser ends House's runtime under an open
+  App, the App keeps running, its `runtime` client and observations included:
+  each observation goes on with the next 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 the Path of one of its
   binary entries, 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.
@@ -69,16 +72,15 @@
   refusal is House's `{ error: { code, retryable } }`, `app_release_not_found` for an
   App with no release; a read House does not answer, or one that outlived
   the browser's signed-in User, is `null`.
-- **External calls** - `callExternal({ url, method, headers, body, slot, room_ref })`
+- **External calls** - `callExternal({ url, method, headers, body, room_ref })`
   has House's server send an HTTPS request to one of the release's declared
   external origins and resolves with the service's `status`, `headers` and its
   body as `body` text or `body_base64`, or a refusal as House's
   `{ error: { code, retryable } }`, or `null` when House does not answer. House fills in the
-  App and its running release; naming an account slot and one of the App's
-  bound Rooms places the key of the account that Room connects to the slot,
-  when the User holds one of the account's roles there, which the App never
-  sees, and naming neither sends no key. A Site's call names no slot, and the House panel names an
-  `account` instead. `body_base64` replaces `body` for bytes.
+  App and its running release. A `room_ref` names a Room the signed-in User binds to the App
+  in a `write` slot, and House adds that Room's Service key for the URL's origin, which App
+  code never sees; a call naming no Room carries no key, and a Site's call names no Room.
+  `body_base64` replaces `body` for bytes.
 - **App messages** - `messages(listener)` hands the listener each message
   another holder of this App sends to this User's running copies, as `from`,
   the sender's User id, and `body`, the JSON value they sent, until the
@@ -111,35 +113,14 @@
   declares them. A Site and the House panel have none: their call rejects with
   an error named and coded `NotSupportedError`, with `retryable` false.
 
-- **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)` once its document has drawn, so the scroll position
-  and focus it sets hold, 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')`. An optional `placed()` resolves once
-  the page has drawn the place it opened on with what that place shows:
-  House keeps its first-preparation surface over a page registered by its
-  first draw until then, and lifts it at the first draw of a page whose
-  cooperation defines none, so the User goes from the surface to a drawn
-  place in one change; a release's readiness check never waits for it.
+- **First place** - `cooperate({ placed })` tells House when the page has
+  drawn the place it opened on; the function it returns withdraws it. Register
+  it in the entry script, before the first draw. `placed()` resolves once the
+  page has drawn that place with what it shows: House keeps its
+  first-preparation surface over a page registered by its first draw until
+  then, and lifts it at the first draw of a page that registered none, so the
+  User goes from the surface to a drawn place in one change. House asks the
+  page for nothing else.
 
 ## The test host
 
@@ -165,7 +146,5 @@ as a browser without push does, settles every `setBadge`, records in `chats`
 each Chat `chat.mount` places, with its `element`, the `options` it was last
 given and whether it is still `mounted`, drawing nothing, delivers each App
 message `message({ from, body })` plays, and hands `bridge.runtime` the MD
-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.
+Runtime client `attachRuntime(client)` gives it. It takes a `cooperate` and
+never calls `placed()`.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentshouse/app-bridge",
-  "version": "0.1.0-cdef4b9ba1d57",
+  "version": "0.1.0-cdf1bbaf17a3f",
   "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, App messages and the Chat, with an accessor and an in-page test host.",
   "license": "MIT",
   "type": "module",

package/dist/mdruntime/shared.d.ts

@@ -1,15 +0,0 @@
-export type Paths<V> = Readonly<Record<string, V>>;
-export declare function entriesIn<V>(map: Paths<V>): Generator<readonly [string, V]>;
-export declare function keysIn(...maps: readonly Paths<unknown>[]): Generator<number, Set<string>, void>;
-export declare function sortedKeys(map: Paths<unknown>): Generator<number, readonly string[], void>;
-export declare function sorting(keys: Iterable<string>): Generator<number, readonly string[], void>;
-export declare function sharing<V>(map: Paths<V>): Generator<number, Paths<V>, void>;
-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 patching<V>(base: Paths<V>, set: Iterable<readonly [string, V]>, removed?: Iterable<string>): Generator<number, Paths<V>, void>;
-export declare function sizeOf<V>(map: Paths<V>): number;
-export declare function differences<V>(left: Paths<V>, right: Paths<V>, same?: (left: V, right: V) => boolean): Generator<number, ReadonlySet<string>, void>;
-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 declare function settling<V>(draft: Record<string, V>): Generator<number, Paths<V>, void>;

package/dist/mdruntime/transfer.d.ts

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