@agentshouse/app-bridge 0.1.0-c4999e714a13d → 0.1.0-c4e2f96a8f06c

package/README.md

@@ -3,16 +3,16 @@
 The types of the agents.house App bridge, an accessor and an in-page test host.
 House builds the bridge object in every App it serves and hands it to the page
 before the App's own scripts run; `houseBridge()` returns that object, so an App
-carries no bridge code of its own. It carries eleven families: navigation,
+carries no bridge code of its own. It carries twelve families: navigation,
 ceremonies, installation, notifications, status, Site image reads, App release
-code, external calls, App messages and App and Site screenshot reads.
+code, external calls, App messages, App and Site screenshot reads and the Chat.
 [docs/families.md](docs/families.md) describes each and the test host.
 
 The bridge carries no credential handling and no Runtime family. House builds
-the MD Runtime client into the page beside the bridge, and `bridge.runtime`
-resolves to that client, so the App imports and constructs none.
+the MD Runtime client into the page beside the bridge and serves it the Chat, so
+the App imports, constructs and bundles neither: `bridge.runtime` resolves to the client.
 
-House's `find_command` "App" is the guide to building an App or a Site.
+House's guide to building an App is its Guide's `apps/` pages, which `open_guide` opens.
 
 ## Use
 

package/dist/calls.d.ts

@@ -414,48 +414,19 @@ export interface HouseMethods {
     readonly 'record.list': {
         readonly params: {
             readonly room_ref: string;
-            readonly record?: string;
             readonly cursor?: string;
             readonly limit?: number;
             readonly order?: 'asc' | 'desc';
         };
         readonly result: {
-            readonly attachments: readonly {
-                readonly bytes: number;
-                readonly file: string;
-                readonly media_type: string | null;
-                readonly name: string | null;
-                readonly referrer: {
-                    readonly record: string;
-                    readonly room_ref: string;
-                };
-                readonly sha256: string;
-            }[];
-            readonly body: string | null;
-            readonly claimed: unknown;
-            readonly created_at: string;
-            readonly record: string;
-            readonly ref: string;
-        } | {
-            readonly next_cursor?: string;
             readonly records: readonly {
-                readonly attachments: readonly {
-                    readonly bytes: number;
-                    readonly file: string;
-                    readonly media_type: string | null;
-                    readonly name: string | null;
-                    readonly referrer: {
-                        readonly record: string;
-                        readonly room_ref: string;
-                    };
-                    readonly sha256: string;
-                }[];
-                readonly body: string | null;
-                readonly claimed: unknown;
-                readonly created_at: string;
                 readonly record: string;
                 readonly ref: string;
+                readonly created_at: string;
+                readonly body: string | null;
+                readonly claimed: unknown;
             }[];
+            readonly next_cursor?: string;
         };
     };
     readonly 'relay.read': {
@@ -957,6 +928,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 position: number;
                     readonly outcome: 'requested';
@@ -1006,19 +978,21 @@ 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';
+                    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 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';
+                    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 retry_at: string;
                 } | {
                     readonly position: number;
                     readonly outcome: 'withdrawn';
+                    readonly code: 'agent_unavailable';
                 } | {
                     readonly position: number;
                     readonly outcome: 'failed';
+                    readonly code: 'internal_error' | 'routine_request_not_started';
                 } | {
                     readonly position: number;
                     readonly outcome: 'waiting';

package/dist/index.d.ts

@@ -134,8 +134,29 @@ export interface HouseCooperation {
     ready(): Promise<boolean> | boolean;
     settle(activation: HouseActivation): void;
 }
+export type HouseChatWidth = 'full' | '3/4' | '1/2' | '1/3';
+export interface HouseChatOpened {
+    readonly conversation: string | null;
+    readonly agent: string | null;
+}
+export interface HouseChatOptions {
+    readonly conversation?: string | null;
+    readonly agent?: string | null;
+    readonly showChats?: boolean;
+    readonly width?: HouseChatWidth;
+    readonly onOpen?: (opened: HouseChatOpened) => void;
+    readonly onLink?: (href: string) => void;
+}
+export interface HouseMountedChat {
+    update(options: HouseChatOptions): void;
+    unmount(): void;
+}
+export interface HouseChat {
+    mount(element: object, options?: HouseChatOptions): Promise<HouseMountedChat>;
+}
 export interface HouseBridge {
     readonly runtime: Promise<HouseRuntime>;
+    readonly chat: HouseChat;
     address(): string | null;
     onAddress(listener: (address: string) => void): () => void;
     push(address: string): Promise<string>;

package/dist/mdmodel/condition.d.ts

@@ -121,7 +121,6 @@ export type ItemFacts = {
     readonly delivery: string;
     readonly source: string | null;
     readonly address: string | null;
-    readonly has_attachment: boolean;
     readonly container: string | null;
     readonly author: string | null;
     readonly headers: Readonly<Record<string, string>>;

package/dist/mdmodel/definition.d.ts

@@ -60,6 +60,7 @@ export declare const JSON_TYPES: readonly JsonType[];
 export declare const BUILT_IN_TYPE = "any";
 export declare const ATTACHMENT = "attachment";
 export declare const ARRAY_INDEX: RegExp;
+export declare const JSON_POINTER: RegExp;
 export declare function escapePointer(key: string): string;
 export declare function pointerSegments(pointer: string): string[];
 export declare function refTarget(reference: string, defs: Readonly<Record<string, unknown>>): {

package/dist/mdmodel/index.d.ts

@@ -10,7 +10,7 @@ export type { RoomTarget } from './paths.js';
 export { MARKDOWN_SYNTAX_PROFILE } from './profile.js';
 export { project } from './project.js';
 export { references } from './references.js';
-export { ARRAY_INDEX, ATTACHMENT, crossedFacts, escapePointer, itemFacts, memberFacts, pointerFacts, pointerSegments, } from './definition.js';
+export { ARRAY_INDEX, ATTACHMENT, crossedFacts, escapePointer, itemFacts, JSON_POINTER, memberFacts, pointerFacts, pointerSegments, } from './definition.js';
 export type { Definition, FieldRules, JsonType, PatternFacts, PointerFacts, RuleValue, SectionSpec, Shape, Transition, ValueFacts, } from './definition.js';
 export type { ApplyResult, BodyResult, Change, Division, DivisionContext, Document, DocumentCheck, Frontmatter, FrontmatterResult, Library, ModelVerification, Link, ParseResult, Projection, ProjectionContext, Reached, Reference, Refusal, RoomReference, Span, Validation, ValidationContext, ValidationStep, VerifiedModel, } from './types.js';
 export { assess, bodyRoomLinks, checkDocument, resolves, roomReferences, sectionReferences, validate, validating, verdicts, verify, } from './validate.js';

package/dist/mdmodel/types.d.ts

@@ -2,6 +2,7 @@ import type { Definition } from './definition.js';
 export type Library = Readonly<Record<string, string>>;
 export type VerifiedModel = {
     readonly types: Readonly<Record<string, Definition>>;
+    readonly nameable?: readonly string[];
 };
 export type ModelVerification = {
     readonly verdict: 'accept';

package/dist/mdruntime/adapter.d.ts

@@ -269,7 +269,6 @@ export type HeadChange = {
     time: string;
 };
 export type BinaryFile = {
-    fileRef: string;
     byteLength: number;
     mediaType: string;
     sha256: string;
@@ -290,10 +289,15 @@ export type BootstrapRequest = {
     selection: string;
     pageToken?: PageToken;
     held?: HeldContent;
+    received?: Uint8Array;
+    arriving?: (bytes: number) => void;
+};
+export type BootstrapInventory = {
+    readonly parts: number;
+    readonly bytes: number;
 };
 export type RoomModels = {
     collection?: ModelResult;
-    selection?: ModelResult;
 };
 export type BootstrapPage = {
     kind: 'bootstrap';
@@ -306,6 +310,8 @@ export type BootstrapPage = {
     binaryFiles: Readonly<Record<string, BinaryFile>>;
     folders?: readonly string[];
     pageToken?: PageToken;
+    inventory?: BootstrapInventory;
+    received?: Uint8Array;
 };
 export type BootstrapResult = BootstrapPage | {
     kind: 'beyond-horizon';
@@ -412,15 +418,6 @@ export type BinaryRequest = {
     locator: string;
     path: string;
     revision: string;
-    fileRef?: string;
-} | {
-    kind: 'reference';
-    fileRef: string;
-    referrer: unknown;
-};
-export type ReferrerScope = {
-    locator: string;
-    path?: string;
 };
 export type BinaryResult = {
     kind: 'binary';
@@ -497,6 +494,7 @@ export type Adapter = {
     readonly localSaves?: true;
     readonly exhaustiveDiscovery?: true;
     readonly roomTypes?: string;
+    readonly nameableRoomTypes?: readonly string[];
     authorize(): Promise<Authorization>;
     discover(authorization: Authorization, scope?: DiscoveryScope): Promise<DiscoverResult>;
     bootstrap(authorization: Authorization, request: BootstrapRequest): Promise<BootstrapResult>;
@@ -504,10 +502,7 @@ export type Adapter = {
     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>;
-    link(authorization: Authorization, request: Extract<BinaryRequest, {
-        kind: 'path';
-    }>): Promise<BinaryLinkResult>;
-    referrerScope(referrer: unknown): ReferrerScope | null;
+    link(authorization: Authorization, request: BinaryRequest): Promise<BinaryLinkResult>;
     action(authorization: Authorization, request: ActionRequest): Promise<ActionResult>;
     reached(locator: string, roomVersion: string, target: string): boolean;
     follows(locator: string, roomVersion: string, next: string): boolean;

package/dist/mdruntime/binary.d.ts

@@ -3,7 +3,6 @@ export type BinaryFileRecord = {
     readonly state: 'accepted';
     readonly revision: string;
     readonly path: string;
-    readonly fileRef: string;
     readonly byteLength: number;
     readonly mediaType: string;
     readonly sha256: string;
@@ -15,8 +14,4 @@ export type BinaryFileRecord = {
     readonly mediaType: string;
     readonly sha256: string;
 };
-export type BinaryReference = {
-    readonly fileRef: string;
-    readonly referrer: unknown;
-};
 export declare function binaryRecord(path: string, held: HeldBinary, revision: string | undefined): BinaryFileRecord;

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

@@ -2,11 +2,6 @@ export type DocumentChange = {
     readonly locator: string;
     readonly path: string | null;
 };
-export type MessageChange = {
-    conversation: string;
-    identity: string;
-    text: string | null;
-};
 export type ChangeSet = {
     documents: readonly DocumentChange[];
     drafts: readonly {
@@ -16,7 +11,6 @@ export type ChangeSet = {
     rooms: readonly string[];
     queues: readonly string[];
     presentations: readonly string[];
-    messages: readonly MessageChange[];
     conversations: readonly string[];
 };
 type Changed = {
@@ -27,7 +21,7 @@ type Changed = {
     presentation?: string;
 };
 export declare function changeSet(locator: string, changed?: Changed): ChangeSet;
-export declare function conversationChangeSet(messages: readonly MessageChange[], conversations: readonly string[]): ChangeSet;
+export declare function conversationChangeSet(conversations: readonly string[]): ChangeSet;
 export declare function mergeChangeSets(sets: readonly ChangeSet[]): ChangeSet;
 export declare function touches(set: ChangeSet, locator: string, path: string): boolean;
 export {};

package/dist/mdruntime/client.d.ts

@@ -2,7 +2,6 @@ import type { AppRoom, ConnectionRefusal, HistoryQuery, RoomSchemas, SavedParts,
 import type { Member, ServiceMode } from './adapter.js';
 import type { ChatDraft, ConversationAgent, ConversationEntry, ConversationOptions, ConversationView } from './conversation.js';
 import { type Observation } from './observation.js';
-import type { BinaryReference } from './binary.js';
 import type { ChosenFile } from './file.js';
 import type { BinaryAnswer, BinaryLinkAnswer, CallResult, HistoryAnswer, Offline, QueueEntry, Resolution } from './outcome.js';
 import type { DocumentQuery, DocumentResult, GroupQuery, GroupResult, PendingResult } from './query.js';
@@ -22,7 +21,7 @@ export type MdRuntimeClient = {
     roomDraft: {
         list(): Promise<readonly RoomDraft[]>;
         read(room: string, path: string): Promise<RoomDraft | null>;
-        write(room: string, path: string, revision: string | null, parts: RoomDraftParts): Promise<RoomDraftWrite>;
+        write(room: string, path: string, revision: string | null, parts: RoomDraftParts, next?: string): Promise<RoomDraftWrite>;
         discard(room: string, path: string, revision: string): Promise<RoomDraftWrite>;
     };
     save(room: string, roomDrafts: readonly SavedRoomDraft[]): Promise<SaveResult>;
@@ -54,7 +53,6 @@ export type MdRuntimeClient = {
     binaryFile: {
         read(room: string, path: string, revision?: string): Promise<BinaryAnswer>;
         link(room: string, path: string, revision?: string): Promise<BinaryLinkAnswer>;
-        readReference(reference: BinaryReference): Promise<BinaryAnswer>;
     };
     call(name: string, input: unknown): Promise<CallResult>;
     reached(locator: string, roomVersion: string, path?: string): Promise<boolean>;
@@ -86,6 +84,7 @@ export type MdRuntimeClient = {
 export declare function connectMdRuntime(port: RuntimePort): MdRuntimeClient;
 export declare function inTurn(client: MdRuntimeClient, work: () => Promise<void>): Promise<void>;
 export { chainedWindows, type WindowAnswer, type WindowChain } from './chain.js';
+export { roomDraftRevision } from './identity.js';
 export type { Observation } from './observation.js';
 export type { Open } from './open.js';
 export { unanswered, type RuntimePort, type WireMember } from './wire.js';

package/dist/mdruntime/compile.d.ts

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

package/dist/mdruntime/connection.d.ts

@@ -7,14 +7,13 @@ import { type Adapter, type Authorization, type Member, type ProviderRefusal, ty
 import { type ChatDraftSurface, type ConversationAgent, type ConversationEntry, type ConversationOptions, type ConversationSurface, type ConversationView } from './conversation.js';
 import { type WrittenBy } from './change.js';
 import type { Open } from './open.js';
-import { type BinaryReference } from './binary.js';
 import { type BinaryLinkAnswer, type CallResult, type HeldBinaryAnswer, type HistoryAnswer, type QueueEntry, type Resolution } from './outcome.js';
 import { type Recovery } from './recovery.js';
 import { type SaveRefusal } from './save.js';
 import { type RoomDraft, type RoomDraftParts, type RoomDraftWrite } from './room-draft.js';
 import { type SyncStatus } from './status.js';
 import { type RuntimeShell } from './durability.js';
-import { type CapacityCause, type CodeAvailability, type Persistence, type Readiness, type SearchObligation } from './readiness.js';
+import { type CodeAvailability, type Persistence, type Readiness, type SearchObligation, type Space } from './readiness.js';
 import type { RuntimeDatabase } from './tables.js';
 import { type NarrowedView, type PortReach, type RuntimeView } from './reach.js';
 export type AppTypedSelection = {
@@ -73,7 +72,7 @@ export type SavedParts = {
 export type RoomDraftSurface = {
     list(): Promise<readonly RoomDraft[]>;
     read(room: string, path: string): Promise<RoomDraft | null>;
-    write(room: string, path: string, revision: string | null, parts: unknown): Promise<RoomDraftWrite>;
+    write(room: string, path: string, revision: string | null, parts: unknown, next?: string): Promise<RoomDraftWrite>;
     discard(room: string, path: string, revision: string): Promise<RoomDraftWrite>;
 };
 export type PresentationSurface = {
@@ -84,7 +83,6 @@ export type PresentationSurface = {
 export type BinaryFileSurface = {
     read(room: string, path: string, revision?: string): Promise<HeldBinaryAnswer>;
     link(room: string, path: string, revision?: string): Promise<BinaryLinkAnswer>;
-    readReference(reference: BinaryReference): Promise<HeldBinaryAnswer>;
     part(file: string, part: number): Promise<Uint8Array | null>;
 };
 export type HistoryQuery = {
@@ -138,7 +136,7 @@ export type RuntimeTopic = 'rooms' | 'readiness' | 'connection-refusal' | 'stora
 export type ReadinessPort = {
     readonly target: string;
     readonly code: CodeAvailability;
-    readonly capacity: CapacityCause | null;
+    readonly space: Space | null;
     readonly search: SearchObligation;
 };
 export type ComposedRuntime = RuntimeView & {
@@ -146,6 +144,7 @@ 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

@@ -85,6 +85,7 @@ export type ConversationDependencies = {
     stream(): ConversationStream | undefined;
     publish(set: ChangeSet): void;
     online(): boolean;
+    full(): boolean;
     closed(): boolean;
     unanswered(): void;
     expired(operation: string): boolean;
@@ -112,5 +113,6 @@ export type ConversationStore = {
 };
 export declare function unheldView(conversation: string): ConversationView;
 export declare const SESSION_STARTED = "Session started";
+export declare const HISTORY_CONVERSATIONS = 64;
 export declare function newChat(agent: string): string;
 export declare function createConversationStore(deps: ConversationDependencies): ConversationStore;

package/dist/mdruntime/durability.d.ts

@@ -1,15 +1,12 @@
 import type { Persistence } from './readiness.js';
-export type StorageEstimate = {
-    readonly usage: number;
-    readonly total: number;
-};
 export type RuntimeShell = {
     persistence: Persistence;
     generation: string | null;
+    onScreen: boolean;
     keepGeneration(value: string): void | Promise<void>;
     dropGeneration(): void | Promise<void>;
-    estimate?(): Promise<StorageEstimate | null>;
     cleanUp?(): Promise<number>;
 };
+export declare function refusedForSpace(error: unknown): boolean;
 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/fulltext.d.ts

@@ -0,0 +1,26 @@
+import { type QueryRoom } from './compile.js';
+import type { Plan } from './query.js';
+import type { HitCursor, SearchWindow } from './search.js';
+import type { Connection } from './tables.js';
+export declare const SEARCH_TABLES: readonly string[];
+export type SearchAsk = {
+    readonly text: string;
+    readonly limit: number;
+    readonly after: readonly [HitCursor, HitCursor] | null;
+    readonly total: boolean;
+    readonly documents: {
+        readonly plan: Plan;
+        readonly rooms: readonly QueryRoom[];
+        readonly beneath: readonly {
+            readonly key: number;
+            readonly roots: readonly string[];
+        }[];
+    } | null;
+    readonly conversations: readonly string[];
+};
+export declare function indexDocument(connection: Connection, id: number, path: string, content: string): void;
+export declare function indexMessage(connection: Connection, id: number, text: string): void;
+export declare function unindexDocuments(connection: Connection, ids: Iterable<number>): void;
+export declare function unindexMessages(connection: Connection, ids: Iterable<number>): void;
+export declare function unindexAll(connection: Connection): void;
+export declare function searched(connection: Connection, ask: SearchAsk): SearchWindow;

package/dist/mdruntime/identity.d.ts

@@ -0,0 +1,6 @@
+export declare function changeBatchIdentity(at?: number): string;
+export declare function identityTime(identity: string): number;
+export declare function roomDraftRevision(): string;
+export declare function chatDraftRevision(): string;
+export declare function transferIdentity(): string;
+export declare function binaryLocalId(): string;

package/dist/mdruntime/messages.d.ts

@@ -0,0 +1,27 @@
+import type { AcceptedMessage } from './adapter.js';
+import type { Connection } from './tables.js';
+export declare const MESSAGE_TABLES: readonly string[];
+export type HeldConversation = {
+    readonly conversation: string;
+    readonly read: string | null | undefined;
+    readonly partial: boolean;
+};
+export type MessageWindow = {
+    readonly messages: AcceptedMessage[];
+    readonly more: boolean;
+};
+export type ConversationWrite = {
+    readonly conversation: string;
+    readonly messages: readonly AcceptedMessage[];
+    readonly read?: {
+        readonly at: string | null;
+        readonly partial: boolean;
+    };
+};
+export declare function heldConversations(connection: Connection): HeldConversation[];
+export declare function keptMessages(connection: Connection, { conversation, messages, read }: ConversationWrite): null;
+export declare function messageWindow(connection: Connection, conversation: string, limit: number, before: readonly [string, string] | null): MessageWindow;
+export declare function messageCount(connection: Connection, conversation: string): number;
+export declare function turnArrived(connection: Connection, conversation: string, turn: string): boolean;
+export declare function droppedMessages(connection: Connection, conversations: readonly string[]): void;
+export declare function forgottenMessages(connection: Connection): void;

package/dist/mdruntime/outcome.d.ts

@@ -44,7 +44,6 @@ export declare const UNREADABLE: Refused<'unreadable'>;
 export declare const LOCKED_UNREADABLE: Refused<'unreadable'>;
 export declare const ABSENT_TARGET: Refused<'absent'>;
 export declare function absentBinary(path: string): Refused<'absent'>;
-export declare function absentReference(fileRef: string): Refused<'absent'>;
 export declare function binaryAnswer(result: KeptResult): HeldBinaryAnswer;
 export declare function binaryLinkAnswer(result: BinaryLinkResult): BinaryLinkAnswer;
 export declare const ROOM_LOCKED = "room-locked";

package/dist/mdruntime/query.d.ts

@@ -58,6 +58,7 @@ export type Select = 'all' | {
     backlinks?: true;
     change?: true;
     fileId?: true;
+    revision?: true;
 };
 export type OrderOptions = {
     nulls?: 'first' | 'last';
@@ -103,6 +104,7 @@ export type QueryDocument = {
     backlinks?: readonly Backlink[];
     change?: HeadChange | null;
     fileId?: string | null;
+    revision?: string | null;
     binaryFile?: BinaryFileRecord;
 };
 export type QueryGroup = {
@@ -119,7 +121,7 @@ export type QueryCoverage = {
     indexes: readonly string[];
     overlay: readonly string[];
 };
-export type Awaits = Open<'acquisition' | 'preparation' | 'index' | 'unlock'>;
+export type Awaits = Open<'acquisition' | 'preparation' | 'unlock'>;
 export type PendingRoom = {
     room: string;
     awaits: Awaits;
@@ -214,6 +216,7 @@ export type DocumentShape = {
     backlinks: boolean;
     change: boolean;
     fileId: boolean;
+    revision: boolean;
     orderBy: readonly {
         key: KeyPlan;
         options: OrderOptions & {

package/dist/mdruntime/reach.d.ts

@@ -1,4 +1,3 @@
-import type { ReferrerScope } from './adapter.js';
 import type { MdRuntime, ReadinessPort, RuntimeTopic } from './connection.js';
 import type { Plan, PlanReach, QueryResult } from './query.js';
 import type { Readiness } from './readiness.js';
@@ -28,7 +27,6 @@ export type Reachable = RuntimeView & {
     watchPlan(plan: Plan, deliver: (message: unknown) => void): () => void;
     search(input: unknown, reach: PortReach | null, locked: readonly string[]): Promise<SearchResult>;
     watchReadiness(port: ReadinessPort, reach: PortReach | null, deliver: (readiness: Readiness) => void): () => void;
-    referrerScope(referrer: unknown): ReferrerScope | null;
     locked(room: string): boolean;
     lockedRooms(): readonly string[];
     watchLocks(notify: () => void): () => void;

package/dist/mdruntime/readiness.d.ts

@@ -1,11 +1,11 @@
 import type { Open } from './open.js';
 export type CodeAvailability = Open<'stored' | 'absent'>;
-export type RoomPreparation = Open<'complete' | 'acquiring' | 'preparing' | 'indexing' | 'refused' | 'unadmitted'>;
+export type RoomPreparation = Open<'complete' | 'acquiring' | 'preparing' | 'refused' | 'unadmitted'>;
 export type RoomCoverage = {
     readonly room: string;
     readonly state: RoomPreparation;
 };
-export type ConversationCoverage = Open<'complete' | 'acquiring' | 'indexing' | 'undeclared'>;
+export type ConversationCoverage = Open<'complete' | 'acquiring' | 'undeclared'>;
 export type SearchObligation = Open<'required' | 'unused'>;
 export type TargetCoverage = {
     readonly complete: boolean;
@@ -18,17 +18,28 @@ 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' | 'storage-exceeded'>;
-    readonly needed: number | null;
-    readonly available: number | null;
-};
+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 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 Readiness = {
     readonly status: ReadinessStatus;
@@ -40,7 +51,8 @@ export type Readiness = {
     readonly persistence: Persistence;
     readonly connection: ConnectionAvailability;
     readonly house: HouseOutcome;
-    readonly capacity: CapacityCause | null;
+    readonly space: Space | null;
+    readonly installation: Installation;
     readonly refused: readonly RefusedRoom[];
     readonly lost: boolean;
 };
@@ -48,5 +60,4 @@ export type ReadinessFacts = Omit<Readiness, 'status' | 'ready' | 'usable' | 'du
     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

@@ -1,4 +1,4 @@
-import type { MutationResult, OperationScopes, ReplicaAdmission, TypedSelection } from './adapter.js';
+import type { BootstrapInventory, MutationResult, OperationScopes, ReplicaAdmission, TypedSelection } from './adapter.js';
 import { type ChangeBatch, type Precondition } from './change.js';
 import { type Collection, type Composition } from './collection.js';
 import type { ModelState } from './model.js';
@@ -12,10 +12,10 @@ export type ReplicaRecord = {
     readonly replica: ReplicaAdmission;
     readonly model: ModelState;
     readonly typedSelection: TypedSelection | null;
-    readonly selectionModel: ModelState;
     readonly providerOwnedPaths: readonly string[];
     readonly roomVersion: string;
     readonly transfer: string;
+    readonly inventory: BootstrapInventory | null;
     readonly key: number;
 };
 export type HeldReplica = {
@@ -24,6 +24,7 @@ export type HeldReplica = {
     readonly overlaid: ReadonlySet<string>;
     readonly count: number;
     readonly confirmed: number;
+    readonly indexed: boolean;
 };
 export type VisibleLayer = Layer & {
     readonly collection: Collection;
@@ -32,7 +33,7 @@ export type Slice = Layer & {
     readonly written: Readonly<Record<string, string>>;
     readonly held: ReadonlySet<string>;
 };
-export declare function compositionOf(record: Pick<ReplicaRecord, 'model' | 'typedSelection' | 'selectionModel'>): Composition;
+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>;

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

@@ -127,6 +127,7 @@ export type SavedDraft = {
     readonly parts: HeldParts;
 };
 export declare function readParts(value: unknown): RoomDraftParts;
+export declare function gatheredParts(earlier: unknown, later: unknown): unknown;
 export declare function held(current: HeldParts | undefined, parts: RoomDraftParts, file?: HeldFile): HeldParts;
 export declare function underneath(parts: HeldParts, path: string, visible: VisibleLayer | undefined): ChangedUnderneath;
 export declare function heldFile(blob: Blob, base: string | null): Promise<HeldFile>;

package/dist/mdruntime/search.d.ts

@@ -1,5 +1,4 @@
 import type { ProviderRefusal } from './adapter.js';
-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'>;
@@ -12,29 +11,32 @@ export type SearchRequest = {
     after?: string;
     total?: true;
 };
+export type MessagePart = Open<'text'>;
+export type Snippet<Part extends string> = {
+    part: Part;
+    text: string;
+    at: readonly [number, number];
+};
 export type DocumentHit = {
     room: string;
     path: string;
     type: string;
     score: number;
     matches: Readonly<Record<string, readonly DocumentPart[]>>;
+    snippet?: Snippet<DocumentPart>;
 };
 export type MessageHit = {
     conversation: string;
     identity: string;
     score: number;
-    matches: Readonly<Record<string, readonly Open<'text'>[]>>;
+    matches: Readonly<Record<string, readonly MessagePart[]>>;
+    snippet?: Snippet<MessagePart>;
 };
 export type SearchCoverage = {
     rooms: readonly CoveredRoom[];
     conversations: readonly string[];
-    index: string;
     overlay: readonly string[];
 };
-export type PendingConversation = {
-    conversation: string;
-    awaits: Open<'index'>;
-};
 export type SearchHits = {
     documents: readonly DocumentHit[];
     messages: readonly MessageHit[];
@@ -47,7 +49,7 @@ export type SearchWindow = SearchHits & {
     };
 };
 export type SearchPending = SearchHits & {
-    pending: readonly (PendingRoom | PendingConversation)[];
+    pending: readonly PendingRoom[];
     coverage: SearchCoverage;
 };
 export type SearchUndeclared = ProviderRefusal & {
@@ -57,24 +59,7 @@ export type SearchResult = (SearchWindow & {
     coverage: SearchCoverage;
 }) | SearchPending | SearchUndeclared;
 export declare function undeclaredSearch(): SearchUndeclared;
-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): AsyncIterable<readonly SearchedDocument[]>;
-    documents(room: string, paths: readonly string[]): Promise<readonly SearchedDocument[]>;
-};
-type HitCursor = readonly [number, string, string] | readonly [] | null;
+export type HitCursor = readonly [number, string, string] | readonly [] | null;
 export type SearchPlan = {
     text: string;
     documents: unknown;
@@ -84,21 +69,4 @@ export type SearchPlan = {
     after: readonly [HitCursor, HitCursor] | null;
     total: boolean;
 };
-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[], rooms: ReadonlySet<string> | null, selections: ReadonlyMap<string, readonly string[]> | null): SearchWindow;
-};
 export declare function searchPlanOf(input: unknown): SearchPlan;
-export declare function createSearchIndex(source: SearchSource): SearchIndex;
-export {};

package/dist/mdruntime/store.d.ts

@@ -1,16 +1,18 @@
-import type { Capability, Member, ProviderLimit } from './adapter.js';
-import type { AcceptedMessage, KeptReceipt } from './adapter.js';
+import type { BootstrapInventory, Capability, KeptReceipt, 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 { Later } from './turn.js';
 import type { Submission } from './outcome.js';
 import type { RoomDraftRecord, SavedDraft } from './room-draft.js';
 import type { ModelState } from './model.js';
-import type { SearchedDocument } from './search.js';
-import type { CommittedWrite, CountedRoom, HeldEntry, QueryAnswer, QueryRoom, Referrer, RoomCommit, RuntimeDatabase, StoredEntry, StoredFile, TypedEntry, View, Walked } from './tables.js';
-export declare const STORE_SCHEMA = 26;
+import type { SearchWindow } from './search.js';
+import type { CommittedWrite, ConversationWrite, CountedRoom, HeldConversation, HeldEntry, MessageWindow, QueryAnswer, QueryRoom, Referrer, RoomCommit, RuntimeDatabase, SearchAsk, StoredEntry, StoredFile, TypedEntry, View, Walked } from './tables.js';
+export type { ConversationWrite, HeldConversation, MessageWindow } from './tables.js';
+export type TransferWriting = {
+    readonly token: string | null;
+    readonly written: number;
+};
 export type TransferRecord = {
     readonly locator: string;
     readonly transfer: string;
@@ -18,9 +20,11 @@ export type TransferRecord = {
     readonly from: string;
     readonly last: string;
     readonly pageToken: string | null;
+    readonly writing: TransferWriting | null;
+    readonly inventory: BootstrapInventory | null;
+    readonly done: BootstrapInventory;
     readonly models: {
         readonly collection: ModelState;
-        readonly selection: ModelState;
     };
     readonly key: number | null;
 };
@@ -45,23 +49,6 @@ export type PresentationRecord = {
     app: string;
     value: unknown;
 };
-export type HeldConversation = {
-    conversation: string;
-    read: string | null | undefined;
-    partial: boolean;
-};
-export type MessageWindow = {
-    messages: AcceptedMessage[];
-    more: boolean;
-};
-export type ConversationWrite = {
-    conversation: string;
-    messages: readonly AcceptedMessage[];
-    read?: {
-        at: string | null;
-        partial: boolean;
-    };
-};
 export type ChatSubmission = {
     readonly operation: string;
     readonly text: string;
@@ -102,7 +89,7 @@ export type RefreshedPage = StagedPage & {
 export type Opened = {
     readonly rooms: ReadonlyMap<string, ReplicaRecord>;
     readonly transfers: ReadonlyMap<string, TransferRecord>;
-    readonly unprepared: ReadonlySet<number>;
+    readonly unindexed: ReadonlySet<number>;
     readonly overlaid: ReadonlyMap<number, ReadonlySet<string>>;
     readonly erasing: boolean;
     readonly orphans: readonly number[];
@@ -134,11 +121,10 @@ export type RuntimeStore = {
         readonly revision: string;
     }[]>;
     typedWithin(key: number, view: View, roots: readonly string[], within: boolean): Promise<boolean>;
-    searched(key: number, locator: string, after: string | null, limit: number, paths: readonly string[] | null): Promise<{
-        readonly documents: readonly SearchedDocument[];
-        readonly next: string | null;
-    }>;
-    stage(record: TransferRecord, composition: Composition, page: StagedPage, key: number | null, last: boolean): Promise<number | null>;
+    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>;
+    keepPart(locator: string, token: string, part: Uint8Array): Promise<void>;
     refresh(key: number, page: RefreshedPage): Promise<void>;
     unrefresh(key: number): Promise<void>;
     commit(commit: Commit): Promise<CommittedWrite>;
@@ -157,8 +143,6 @@ export type RuntimeStore = {
     keepMessages(write: ConversationWrite): Promise<void>;
     messageWindow(conversation: string, limit: number, before: readonly [string, string] | null): Promise<MessageWindow>;
     messageCount(conversation: string): Promise<number>;
-    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[]>;
@@ -180,9 +164,5 @@ export type RuntimeStore = {
     generation(): Promise<string | null>;
     rememberGeneration(value: string): Promise<void>;
     file(key: string, type: string): Promise<Blob>;
-    close(): void;
 };
-export declare function transacted<T>(database: IDBDatabase, stores: string | readonly string[], mode: IDBTransactionMode, work: (transaction: IDBTransaction) => Later<T>): Promise<T>;
-export declare function endRuntimeStore(database: RuntimeDatabase, holder: string | undefined): 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, authored: RuntimeDatabase): Promise<RuntimeStore>;
+export declare function openRuntimeStore(fenced: (locator: string) => boolean, authored: RuntimeDatabase): RuntimeStore;

package/dist/mdruntime/stored.d.ts

@@ -1,7 +1,6 @@
 import type { HeadChange } from './adapter.js';
 import type { Composition } from './collection.js';
 import type { HeldBinary } from './overlay.js';
-import type { SearchedDocument } from './search.js';
 import type { Connection } from './tables.js';
 export declare const REPLICA_TABLES: readonly string[];
 export type View = 'confirmed' | 'visible' | 'refreshed';
@@ -85,7 +84,7 @@ export type RoomCommit = {
 export type Committed = {
     readonly counts: Readonly<Record<string, number>>;
     readonly changed: Readonly<Record<string, readonly string[] | null>>;
-    readonly prepared: Readonly<Record<string, boolean>>;
+    readonly indexed: Readonly<Record<string, boolean>>;
 };
 export type CountedRoom = {
     readonly key: number;
@@ -100,11 +99,12 @@ export declare function entered(connection: Connection, locator: string, composi
 export declare function stage(connection: Connection, request: {
     readonly locator: string;
     readonly transfer: string;
-    readonly record: string | null;
+    readonly record: string;
     readonly key: number | null;
     readonly composition: Composition;
     readonly entries: readonly StoredEntry[];
     readonly folders: readonly string[];
+    readonly written?: string;
 }): number;
 export declare function refreshing(connection: Connection, request: {
     readonly key: number;
@@ -134,9 +134,11 @@ export declare function files(connection: Connection, key: number, view: View, a
     readonly revision: string;
 }[];
 export declare function typedWithin(connection: Connection, key: number, view: View, roots: readonly string[], within: boolean): boolean;
-export declare function searched(connection: Connection, key: number, locator: string, after: string | null, limit: number, only: readonly string[] | null): {
-    readonly documents: readonly SearchedDocument[];
-    readonly next: string | null;
-};
+export declare function transferPart(connection: Connection, locator: string, token: string): Uint8Array | null;
+export declare function keepPart(connection: Connection, request: {
+    readonly locator: string;
+    readonly token: string;
+    readonly part: Uint8Array;
+}): null;
 export declare function opened(connection: Connection): ReplicaOpened;
 export declare function ended(connection: Connection): void;

package/dist/mdruntime/tables.d.ts

@@ -1,11 +1,15 @@
 import { type QueryAnswer, type QueryRoom } from './compile.js';
 import type { KeptReceipt } from './adapter.js';
 import type { Composition } 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 { SearchedDocument } from './search.js';
+import type { SearchWindow } from './search.js';
 import { type Committed, type CountedRoom, type HeldEntry, type ReplicaOpened, type Referrer, type RoomCommit, type StoredEntry, type TypedEntry, type View, type Walked } from './stored.js';
 export type { Committed, CountedRoom, HeldEntry, OverlayEntry, ReplicaOpened, Referrer, RoomCommit, StoredEntry, TypedEntry, View, Walked, } from './stored.js';
 export type { QueryAnswer, QueryRoom } from './compile.js';
+export type { SearchAsk } from './fulltext.js';
+export type { ConversationWrite, HeldConversation, MessageWindow } from './messages.js';
 export type Value = string | number | bigint | Uint8Array | null;
 export type Row = Readonly<Record<string, Value>>;
 export interface Connection {
@@ -22,6 +26,15 @@ export interface SqliteEngine {
         heap8u(): Uint8Array;
     };
 }
+export interface SqliteStatement {
+    readonly parameterCount: number;
+    bind(values: readonly Value[]): unknown;
+    step(): boolean;
+    get(values: Value[]): Value[];
+    getColumnNames(names: string[]): string[];
+    resetNoThrow(clearBindings: boolean): number;
+    finalize(): unknown;
+}
 export interface SqliteDatabase {
     readonly pointer: number;
     exec(options: {
@@ -30,6 +43,7 @@ export interface SqliteDatabase {
         readonly rowMode?: 'object';
         readonly returnValue?: 'resultRows';
     }): Row[];
+    prepare(sql: string): SqliteStatement;
 }
 export declare function sqliteConnection(engine: SqliteEngine, database: SqliteDatabase): Connection;
 export declare const FILE_PART_BYTES = 1048576;
@@ -43,6 +57,7 @@ export interface FileSpool {
     held(): Iterable<string>;
     spool(key: string, type: string, parts: Iterable<Uint8Array>): Promise<Blob>;
     drop(key: string): Promise<void>;
+    probe(bytes: number): Promise<void>;
 }
 export type KeptPending = {
     readonly id: string;
@@ -191,16 +206,7 @@ export interface RuntimeRequests {
     readonly 'replica.counts': Asked<{
         readonly rooms: readonly CountedRoom[];
     }, readonly number[]>;
-    readonly 'replica.searched': Asked<{
-        readonly key: number;
-        readonly locator: string;
-        readonly after: string | null;
-        readonly limit: number;
-        readonly paths: readonly string[] | null;
-    }, {
-        readonly documents: readonly SearchedDocument[];
-        readonly next: string | null;
-    }>;
+    readonly 'replica.search': Asked<SearchAsk, SearchWindow>;
     readonly 'replica.received': Asked<Nothing, readonly KeptReceipt[]>;
     readonly 'replica.receivedParts': Asked<{
         readonly key: string;
@@ -209,12 +215,22 @@ export interface RuntimeRequests {
     readonly 'replica.stage': Asked<{
         readonly locator: string;
         readonly transfer: string;
-        readonly record: string | null;
+        readonly record: string;
         readonly key: number | null;
         readonly composition: Composition;
         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.keepPart': Asked<{
+        readonly locator: string;
+        readonly token: string;
+        readonly part: Uint8Array;
+    }, null>;
     readonly 'replica.refresh': Asked<{
         readonly key: number;
         readonly entries: readonly StoredEntry[];
@@ -301,6 +317,24 @@ export interface RuntimeRequests {
         readonly key: string;
         readonly part: number;
     }, Uint8Array | null>;
+    readonly 'conversation.held': Asked<Nothing, readonly HeldConversation[]>;
+    readonly 'conversation.keep': Asked<ConversationWrite, null>;
+    readonly 'conversation.window': Asked<{
+        readonly conversation: string;
+        readonly limit: number;
+        readonly before: readonly [string, string] | null;
+    }, MessageWindow>;
+    readonly 'conversation.count': Asked<{
+        readonly conversation: string;
+    }, number>;
+    readonly 'conversation.turn': Asked<{
+        readonly conversation: string;
+        readonly turn: string;
+    }, boolean>;
+    readonly 'conversation.drop': Asked<{
+        readonly conversations: readonly string[];
+    }, null>;
+    readonly 'space.probe': Asked<Nothing, null>;
 }
 export type RuntimeKind = keyof RuntimeRequests;
 export type RuntimeRequest<K extends RuntimeKind = RuntimeKind> = {

package/dist/mdruntime/wire.d.ts

@@ -54,10 +54,6 @@ declare const MEMBERS: {
         readonly reach: 'within';
         readonly effect: 'read';
     };
-    readonly 'binaryFile.readReference': {
-        readonly reach: 'within';
-        readonly effect: 'read';
-    };
     readonly 'binaryFile.part': {
         readonly reach: 'within';
         readonly effect: 'read';

package/dist/test-host.d.ts

@@ -1,11 +1,17 @@
 import type { MdRuntimeClient } from './mdruntime/client.js';
-import type { HouseActivation, HouseAnalyticsChoice, HouseAppMessage, HouseExternalAnswer, HouseExternalRequest, HouseNavigationMode, HouseRefusal, HouseSourceDownload, HouseSourceTop, HouseStatus, HouseTab, HouseTask } from './index.js';
+import type { HouseActivation, HouseAnalyticsChoice, HouseAppMessage, HouseChatOptions, HouseExternalAnswer, HouseExternalRequest, HouseNavigationMode, HouseRefusal, HouseSourceDownload, HouseSourceTop, HouseStatus, HouseTab, HouseTask } from './index.js';
 export interface HouseBridgeNavigation {
     readonly mode: HouseNavigationMode;
     readonly address: string;
 }
+export interface HouseBridgeChat {
+    readonly element: object;
+    readonly options: HouseChatOptions;
+    readonly mounted: boolean;
+}
 export interface HouseBridgeTestHost {
     readonly navigations: readonly HouseBridgeNavigation[];
+    readonly chats: readonly HouseBridgeChat[];
     readonly ceremonies: readonly string[];
     readonly consents: readonly HouseAnalyticsChoice[];
     readonly tabs: readonly HouseTab[];

package/dist/test-host.js

@@ -50,6 +50,7 @@ export function createHouseBridgeTestHost(options = {}) {
     const consents = [];
     const tabs = [];
     const externalCalls = [];
+    const chats = [];
     const addressListeners = new Set();
     const statusListeners = new Set();
     const messageListeners = new Set();
@@ -100,6 +101,20 @@ export function createHouseBridgeTestHost(options = {}) {
     }
     const bridge = {
         runtime: runtime,
+        chat: {
+            mount(element, options = {}) {
+                const chat = { element, options, mounted: true };
+                chats.push(chat);
+                return Promise.resolve({
+                    update(next) {
+                        chat.options = next;
+                    },
+                    unmount() {
+                        chat.mounted = false;
+                    },
+                });
+            },
+        },
         address: () => shown,
         onAddress(listener) {
             return followHeld(addressListeners, listener, () => shown);
@@ -164,6 +179,7 @@ export function createHouseBridgeTestHost(options = {}) {
     arrive(current);
     return {
         navigations,
+        chats,
         ceremonies,
         consents,
         tabs,

package/docs/families.md

@@ -56,8 +56,8 @@
   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
+- **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.
 - **App release code** - `sourceTop(app, release)` answers the top level of
   the latest successful release of an App the User may use: its folders, its
@@ -84,7 +84,7 @@
   the sender's User id, and `body`, the JSON value they sent, until the
   function it returns is called. App code sends one through the Runtime's
   `call('message.send', { to, body })` with the recipient's User id and
-  a body of at most 32 KiB of JSON; House fills in the App and relays it only
+  a body of at most 32 kB of JSON; House fills in the App and relays it only
   to copies running now, storing nothing. The panel sends none.
 - **App screenshot read** - given an App reference, `readScreenshot(app)`
   answers the image this browser captured of that App's screen the first time
@@ -96,8 +96,23 @@
   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.
 
+- **Chat** - `chat.mount(element, options)` places House's Chat, the one chat
+  in which the User's Agent conversations show, in `element` over the page's
+  `runtime` client, and resolves to a handle: `update(options)` replaces its
+  options and `unmount()` removes it. House serves the Chat with the page and
+  keeps it current, so the App installs and bundles nothing for it. The
+  options: `conversation` opens one, `null` for a new chat, `agent` is the
+  Agent a new chat goes to, `showChats` adds its conversation list, `width` is
+  `full`, the element, or `3/4`, `1/2` or `1/3` of the window docked at its
+  right edge, `onOpen` hears each conversation it opens as
+  `{ conversation, agent }`, and `onLink` takes a link without a scheme in
+  place of the browser. CSS custom properties named `--chat-*` on the element
+  or an ancestor set its look. It shows conversations only to a release that
+  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
+  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
@@ -141,7 +156,9 @@ records in `tabs` each `setTab`, answers a release code read from the
 by App reference and `readSiteScreenshot` from the `siteScreenshots` it was
 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
+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,

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@agentshouse/app-bridge",
-  "version": "0.1.0-c4999e714a13d",
-  "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.",
+  "version": "0.1.0-c4e2f96a8f06c",
+  "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",
   "sideEffects": false,
@@ -23,5 +23,10 @@
     "docs",
     "README.md",
     "LICENSE"
-  ]
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/agentshouse/core.git",
+    "directory": "client"
+  }
 }

package/dist/mdruntime/turn.d.ts

@@ -1,8 +0,0 @@
-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) => Later<R>): Later<R>;
-export declare function paced(): (weight: number) => Later<void>;
-export declare function inUnits<T>(items: Iterable<T>, each: (item: T) => number, ended?: () => void, paused?: () => Promise<void>): Later<void>;
-export declare function finished<R>(steps: Generator<number, R, void>): R;
-export declare function stepped<R>(steps: Generator<number, R, void>): Later<R>;